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DATA UTILITIES Update B 


Preface 


This manual instructs the programmer in the use of the SPERRY UNIVAC Operating 
System/3 (OS/3) data utilities program. 


The manual is divided into the following parts: 


PART 1. INTRODUCTION 


Introduces the data utilities program and briefly describes its uses, characteristics, 
processing methods, and operating environments. 


PART 2. FILE PROCESSING IN A BATCH ENVIRONMENT 


Describes how to use the data utilities program in a batch environment. The data 
utilities control statements, sample job control streams, and jprocs are discussed. 


PART 3. FILE PROCESSING IN AN INTERACTIVE ENVIRONMENT 
Describes the interactive execution of the data utilities program. The dialog 


initiation, file processing operations, output listings, and error messages are 
described. A sample interactive dialog with step-by-step instructions is included. 


PART 4. LOADING LARGE, MULTIKEYED MIRAM FILES 
IN A BATCH ENVIRONMENT 


Introduces and describes how to use MILOAD, a special purpose utility that 
enhances performance when loading large, multikeyed MIRAM files. 


PART 5. APPENDIXES 


Describes the statement conventions. 
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1. Data Utilities Program 


1.1. DATA ROUTINE 


The data utilities program, commonly known as the DATA routine, gives you a 
straightforward, easy-to-use method for reproducing and maintaining your data files. It 
provides the capabilities for transferring files between various peripheral devices, editing 
or correcting data files, and comparing files. 


The DATA routine is your file maintenance routine. All the information concerning file 
processing is submitted either via a job control stream (batch method) or via a question 
and answer session known as a dialog (interactive method). Both the batch and interactive 
methods describe your files to the DATA routine and inform it of the type of processing to 
be accomplished. The DATA routine enables you to compare files or selected areas of a 
file, delete or insert records, copy existing files to any storage device available in your 
system, rearrange records, or produce a printed copy of any file. 


1.2. DATA ROUTINE USE 


The following are a few examples of possible applications of the DATA routine: 


= You might want to transfer data to a different type of device for the purpose of long 
range storage, or to take advantage of a faster access device. 


= Data from one program could be used in another program by reformatting the records 
and transcribing them to a storage medium compatible with the receiving program. 


=m You may select or delete specific areas of a file for testing purposes or report 
preparation. 


. If, for some reason, you need to know the contents of a file, it is readily available to 
you through the use of the print option. 


a To make certain that no discrepancies have occurred during a copy operation, you can 
compare the input file to the output file. 
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1.3. OPERATING ENVIRONMENT @ 


The operating environment for the DATA routine is established at system generation time. 
The operating environment that you choose governs the types of files that you can process 
and how you can execute the DATA routine. You have the following options: 


= Basic Data Management 


The basic data management environment allows you to perform operations on card, 
card image diskette-data set label, tape, printer, and SAM, DAM, NI, ISAM, IRAM, or 
MIRAM disk files. 


= Consolidated Data Management 


The consolidated data management environment allows you to perform operations 
only on consolidated data management files (card, printer, tape, MIRAM disk, MIRAM 
diskette, or data set label diskette). Note that “card image” diskette files can be used 
only as input files in this environment. Also, you can transfer data on diskette from 
System 80 to Series 90 in data set label mode by using consolidated data 
management. 


= Mixed Data Management (Basic and Consolidated) 


The mixed data management environment allows you to perform operations on basic 
data management files (card, card image diskette-data set label, tape, printer, MIRAM 
disk, or MIRAM diskette). In the basic data management environment, data-set label 
diskette files are created as unkeyed MIRAM data files. 





Thus, the operating environment also governs how the DATA routine can be executed. 
Table 1-1 lists the operating environments and how the DATA routine can be executed in 
each case. 


Table 1—1. Operating Environments and Execution Methods 


Operating Environment Execution Method 






Mixed (basic/consolidated) Batch and interactive 
Consolidated data management Batch and interactive 
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1.4. DEVICE UNIT COMBINATIONS 


In the process of copying data from one device to another of the same type, you can move 
data from: 


a Card to card 
= Tape to tape 


. Disk to disk 


You may also transcribe data from one type of storage medium to another. The 
combinations of devices you can use are: 


= Card to tape 

= Card to disk 

= Card to printer 

= Tape to card 

= Tape to disk 

= Tape to printer 

= Disk to card 

= Disk to tape 

# Disk to printer 

In the basic data management environment, input and output data from the SPERRY 
UNIVAC 8413 Diskette Subsystem is processed the same as for the card reader, punch, or 
read/punch device. Therefore, any reference to card reader or punch in the DATA routine 
can also apply to the 8413 diskette subsystem. 

In the consolidated data management environment, input and output data from an 8413 
diskette subsystem is processed the same as for the disk. Therefore, any reference to a 
disk in the DATA routine can also apply to the 8413 diskette. 

As in all areas of OS/3 data utility programming, any of the operations can be performed 
with a minimum of programming effort by the use of a few utility input and output 
statements. All the necessary interfaces with you and with the system operator, including 


related software components and your data files, are accomplished with software 
components of the OS/3 disk operating system. 





UP-8069 Rev. 9 SPERRY UNIVAC OS/3 1-4 


DATA UTILITIES 
a a 


1.5. FILE ORGANIZATION 





When operating in the basic data management environment, your devices are assigned via 
the job control stream. However, when you use either the mixed or the consolidated data 
management environment, your devices are assigned via either the interactive dialog or 
the job control stream. 


In the basic data management environment, your disk files can be organized in one of the 
following access methods: 


s Sequential Access Method (SAM) 


SAM files are constructed sequentially. Records are accessed in the same way, 
starting at the first record and searching through the file until the required record is 
detected. SAM files are used on magnetic tape units, card readers, card punches, 
printer files, and disks. SAM is the only access method that can be used for card, 
tape, and printer files. 


= Indexed Sequential Access Method (ISAM) 
Disk files can use the ISAM organization. Records are written sequentially either by 
record identification, or by key, and then indexed. Records can be retrieved randomly 


by key. 


a Indexed Random Access Method (IRAM) 





Records are written on an IRAM file in the order they are presented. The file may be 
indexed or nonindexed, depending on your requirements. In addition, indexed files 
may be created by means of an orderly load (records submitted in ascending key 
order) or a disorderly load (record keys in no particular order). An IRAM file can be 
accessed in many ways; however, data utilities will access the records consecutively 
only by key or by relative record number. (See the basic data management user guide, 
UP-8068 (current version) for details on other ways to access records in an IRAM 
file.) 


# Multiple Indexed Random Access Method (MIRAM) 


A MIRAM file is similar to an IRAM file in that records are written on the file in the 
order they are presented and the file can be indexed or nonindexed. Disorderly load is 
permitted with indexed files, and it can also be accessed in other ways. However, as 
with an IRAM file, the DATA routine will access records consecutively only by key or 
by relative record number. 


The MIRAM file differs from the IRAM file in that variable-length records, multiple 
keys, duplicate keys, and logical deletion of records from the file are permitted. In 
addition, if multiple keys are specified, a separate index is created for each key type. 


] Direct Access Method (DAM) 





The DAM organization, for use by disk files, constructs a file by relative track 
addressing. Records are accessed by requests for a particular record number. 
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= §=Non-indexed (NI) 


NI allows for multiple partition files and combines the characteristics of SAM and 
DAM. 


When using the consolidated data management environment, only the MIRAM access 
method is applicable. 


In both the basic and consolidated data management environments, the DATA routine 
copy functions are not designed to copy files with user labels. However, you can use a disk 
file with user labels as input, and the data portion can be an output to another disk, card, 
tape, or printer. User labels occupy the first track of the file. When you implement data 
management functions, the DATA routine will bypass the first track and start processing 
the data. For example: 















INPUT1 (DISK) OUTPUT1 (DISK) 
Ey 





You can find detailed information concerning data and file structures in the current 
versions of the basic data management user guide, UP-8068, or the consolidated data 
management concepts and facilities, UP-8825. 


1.6. FILE PROCESSING MODES 


1.6.1. Batch Processing 


Batch processing consists of coding a set of instructions telling the DATA routine your 
processing requirements. These instructions (the job control stream) assign the necessary 
input/output devices and data utilities statements that describe what you want done. 


After you have completed your coding, the job control stream must be transcribed onto 
punched cards or a diskette. The card deck or diskette is then submitted to the system 
operator for subsequent execution. For details, see Part 2. 
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1.6.2. Interactive Processing 


Interactive processing consists of a dialog (question and answer session) that you conduct 
with the DATA routine via a workstation. During the dialog, questions appear on the 
workstation screen. The answers given will assign the necessary input/output devices and 
tell the DATA routine what you want done. 


Interactive processing achieves the same results as batch processing; however, it is much 
simpler to use because: 


= you do not need to be familiar with the job control statements or the DATA routine to 
use it; and 


a the DATA routine is executed immediately (that is, you do not have to wait for the 
system operator to execute it for you). 


For more details on interactive processing, see Part 3. 











PART 2. FILE PROCESSING INA 
BATCH ENVIRONMENT 
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2. Batch Processing Considerations 


2.1. JOB CONTROL STREAM REQUIREMENTS 


You must code a job control stream when you execute the DATA routine in a batch 
environment. The control stream consists of: 


2 // JOB statement 


= Device assignment sets (statements that describe the files you intend to use or 
create) 


ma // EXEC DATA statement 

= Start-of-data statement (/$) 

= Data utilities control statements 

2 End-of-data statement (/*) 

& End-of-job statement (/&) 

a // FIN statement 

= PARAM statements 

You can have your job control stream define your input file in a device assignment set or 
as embedded card data. Embedded card data is inserted between the data delimiters (/$ 
and /*). Jprocs are described in 2.1.11 and a sample job control stream is provided in 
2.1.12. 

2.1.1. // JOB Statement 


The // JOB statement is the first statement in the job control stream. It names the job 
and specifies the amount of main storage required for the job. 
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2.1.2. Device Assignment Set 


The device assignment sets you use in your job control stream consist of the following 
statements that you must use in this order: 


DVC 
VOL 
EXT 
LBL 
LFD 


1. DVC 
Designates the device you require. 
2. VOL 
Identifies a tape or disk volume by serial number. 
3. EXT 
Needed only when you allocate disk space. 
4. LBL 
Identifies a tape or disk file by file identifier. 
5. LFD 


Specifies the logical file name and links your file description with the corresponding 
data management file definition. 


The DVC and LFD statements are always required in your device assignment set. The VOL 
and LBL statements are needed only when a tape or disk file is identified in your job 
control stream. When you are copying to a disk, be sure to allocate sufficient space on the 
disk by using the EXT statement. A device assignment set is not required for the card 
reader if your primary (input) file is embedded card data. 
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To describe your input/output files to the DATA routine, use the following logical file names 
as they apply to the devices you assign to your file: 


Logical File Name Use 


// LFD PRNTR Needed to allocate a printer to the job. If a printer is allocated, 
the DATA routine prints out the start-of-data (/$) statement, 
the Uio statement, any utility modifier statements, and the end- 
of-data (/*) statement as each is read from the control stream. 
Error messages, if applicable, are also printed. 


If a printer is not allocated to the job, no headings or control 
stream listings are generated. If an error should occur, a data 
management DMxx error message and a data utilities DU fatal 
error message are displayed on the system console. If the 
functions specified require a printer and none is allocated, a 
fatal error condition terminates the job. 


A descriptive listing of all data management and data utilities 
error messages is contained in the system messages 
programmer/operator reference, UP-8076 (current version). 


// LFD INPUT1 Needed for all runs except embedded data; defines the input 
file for a copy generation or the primary input file for a 
compare operation. If not present, DATA assumes INPUT1 is 
embedded card data. 


// LED INPUT2 Needed only when a compare operation is specified; defines 
the secondary input. 


// LFD OUTPUT1 Needed for a copy operation only when the printer is not the 
primary output. 


// LFD OUTPUT2 Needed for a copy operation only when the dua! output option 
(DC) specifies card output; defines the card punch. 


The DATA routine also accepts file characteristics from a // DD job control statement. 
When this // DD statement is present within the device assignment set for a file, the 
DATA routine uses the information specified in the // DD statement rather than the 
information provided in the data utilities statements; that is, the // DD statement 
overrides the data utilities statements. For disk input files, the file characteristics specified 
in the format labels override the information in both the data utilities statements and the 
// DD statement. 


The EXEC statement follows the device assignment sets and initiates execution of the 
DATA routine. The parameter for this statement must be DATA. 
2.1.3. // EXEC DATA Statement 


The // EXEC DATA statement follows the device assignment set and starts the execution 
of the DATA routine. 
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2.1.4. Start-of-Data Statement (/$) 

This statement follows the // EXEC DATA statement and indicates the start of the data 
utilities control statements. 

2.1.5. Data Utilities Control Statements 

These statements (the Uio statement and the modifier statements) specify the file 
processing to be performed. A description of the data utilities control statements is found 
in Section 3. 

2.1.6. End-of-Data Statement (/*) 


This statement follows the last data utilities control statement and indicates the end of the 
control statements. 


2.1.7. Embedded Card Data 

The INPUT1 file for data utilities can be entered in your control stream as embedded card 
data. This method eliminates the need for assigning your input files in your job control 
stream. The INPUT1 file and the Uio statement are inserted between two sets of data 
delimiters (/$ and /*). 

2.1.8. End-of-Job Statement (/&) 


This statement indicates the end of the job. 


2.1.9. // FIN Statement 


This statement indicates that no more statements are read for this job control stream and 
turns off the card reader. 


2.1.10. // PARAM Statements 

There are four // PARAM statements you can supply to the DATA routine to control 
operation. They are: // PARAM CONTROL, // PARAM MODE, // PARAM DISPLAY, and 
// PARAM EOJ control statements. When supplied, they must appear immediately 


following the // EXEC DATA statement but before the /$ statement. They are supported 
in all operating environments. 


2.1.10.1. “7 PARAM CONTROL 
Use this statement to print data utilities control statements on the final output. 
Format: 


// PARAM aes s 
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Parameters: 





Specifies that PARAM statements and Uio statements are printed on the final 
output. 


NO 


Specifies that PARAM statements and Uio statements are not printed on the final 
output. 


2.1.10.2. // PARAM MODE 


This statement is used to specify the debug or OS/4-to-OS/3 data conversion mode. 


Debug Mode 


Provides snap dumps of the job region at critical points during execution and is made 
operative by including the following PARAM statement in the control stream 
immediately following the // EXEC DATA statement: 


// PARAM MODE=DBG 


This mode of operation should be used only to provide documentation in reporting a 
software user report (SUR). 


OS/4-to-OS/3 Data Conversion Mode 


Used to convert OS/4 disk files to OS/3 disk files. Before using this mode, you must 
use the OS/4 disk data conversion utility (DCON4) to dump the OS/4 files and their 
characteristics onto a tape file. Then you use the DATA routine to read the tape and 
create OS/3 disk files. (See the UTD statement in 3.2.2.2.) To do this, include the 
following PARAM statement in your control stream immediately following the // 
EXEC DATA statement: 


// PARAM MODE=fJ0S4 
0S4D 


The MODE=OS4 specification produces MIRAM files in a mixed or consolidated data 
management environment. To obtain DTF files, add a D to OS4 (MODE=OS4D). 


You can also convert OS/4 disk files to OS/3 disk files interactively in a mixed or 
consolidated data management environment. The input file is created by using 
DCON4, and the output file is always MIRAM. 


For a detailed description of DCON4 use and the conversion mode, see the OS/4 to 
OS/3 disk data conversion utility user guide/programmer reference, UP-8606 
(current version), and the OS/4 to OS/3 conversion guide user guide/programmer 
reference, UP-8553 (current version). 
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i 


2.1.10.3. // PARAM DISPLAY 





This statement specifies the files where the termination information is written. 
Format: 
// PARAM DISPLAY = (P 
L 


Cc 
NONE 


Parameters: 


Indicates the termination information is listed on the printer. 


Indicates the termination information is written to the system log file. 


c 
Indicates the termination information is displayed on the system console. 
NONE 
Indicates no termination information is written. 
NOTE: 





Any combination (PLC) can be used and commas are not required. If omitted, PLC is 
assumed; however, detail statistics will be written to printer and log files and not displayed 
on the system console. 


2.1.10.4. // PARAM EOJ 
This statement indicates what occurs when the DATA routine terminates. 


Format: 





// PARAM E0J = lea 


Parameters: 


CANCEL 
Indicates that the DATA routine terminates with error code O if a fatal or serious 
error is encountered and the UPSI byte is not modified. 






Indicates that the DATA routine terminates normally in all cases. At job 
termination, the UPSI byte settings (Table 2-1) are listed on the printer. 
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Table 2—1. UPSI Byte Settings 


[eens | cooae | 
x‘00’ 


Informative 








Warning 
Serious 


Fatal 


2.1.11. Job Control Procedure Use 


Each time you use the DATA routine in a batch environment, you must provide a job 
control stream. As time goes on, you will note that you are coding the same sequence of 
job control statements over and over. This repetitious coding can be avoided by using a 
single statement (a job control procedure call statement) in your job control stream in 
place of the job control statements you normally would code. This jproc call statement will 


generate the proper job control statement sequence for you. (For more details, see Section 
5,) 


2.1.12. Sample Job Control Stream 


Figure 2-1 is an example of a DATA routine control stream, showing the device 
assignment set, the EXEC statement, the Uio statement, and the placement of data cards. 


1 10 20 30 





1. |// JOB TESTFIL, ,AGOD 

2. |// DVC 26 // LFO PRNTR 
3. |// DVC 39 // LFD INPUT1 
4. 1// DVC 51 // NOL DSP812 
5. |// EXT $Q,C,,CYL,8 

6. |// LBL WRKFIL3 // LFD OUTPUT1 
7. |// EXEC DATA 

8. |/$ 

9. |UCD keyword parameters 

10.) /* 

11.]/& 

12.]// FIN 

13. data cards 

14.]/* 


Figure 2—1. Sample Job Control Stream for Card-to-Disk Operation 
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Line 1 shows the job beginning, job name of TESTFIL, and the main storage requirements. Line 
2 assigns the printer to the job. Line 3 assigns the card reader as the input file. Line 4 assigns 
the disk file with the volume serial number DSPO12 to this job. Line 5 obtains disk space, 
specifies SAM format, and allocates contiguous cylinder space on eight cylinders. Line 6 
identifies the output file by file name. Line 7 requests the loading and execution of the DATA 
routine. Line 8 designates the start of control cards. Line 9 is the Uio statement that identifies 
this job as a card-to-disk operation and includes any necessary keyword parameters. Line 10 
designates the end of control cards. Line 11 indicates the end of job. Line 12 terminates the 
card reader. Line 13 shows the location of your data cards in the control stream. If your input file 
is to be spooled, you will precede your data cards with a // DATA control statement and follow 
your data cards with a // FIN statement to terminate the card reader. Line 14 designates the 
end of data. 


If you require more detailed information concerning job contro! statements and their 
parameters, refer to the job control user guide, UP-8065 (current version). 


Figure 2-2 is an example of a DATA routine control stream using embedded card data. 





// JOB TESTFIL, ,AS88B 

// DVC 286 // LED PRNTR 

// OVE 51 // NOL DSP812 

// EXT MI,€,,CYL,8 

LBL WRKFIL3 // LFD OUTPUTI1,, INIT 
// EXEC DATA 


co“ DM on fF Ww NR Re 
~ 
ing, 


/$ 
UCD keyword parameters 
9. | /* 
10. | /$ 
11. 
12. 
13.)]. 
14. | embedded card data 
15. 
16. 
17. 
18. | /* 
19 /& 
20 // FIN 


Figure 2—2. Sample Job Control Stream Using Embedded Card Data 


Notice that with embedded card data, the device assignment set for the card reader is not 
needed. Line 10 designates the start-of-data. Lines 11 through 17 show the location of 
your embedded card data. Line 18 signifies the end of data. Line 19 indicates the end of 
job. Line 20 terminates the card reader. 


If you require more detailed information concerning embedded card data, refer to the job 
control user guide, UP-8065 (current version). 
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2.2. FILE COPYING CONSIDERATIONS 


File copying considerations are described for the basic data management and mixed 
operating environments. Since most OS/3 file formats are compatible with each other, the 
DATA routine copies between these files without change. However, in certain cases, the 
DATA routine converts the format of the INPUT1 file to conform to the format of the 
OUTPUT1/OUTPUT2 file. 


These conversions are not performed if you specify field select. When you use field select, 
the DATA routine assumes that you are performing all necessary conversions. For file 
compare (K2), the DATA routine converts the input record before the comparison is made. 
2.2.1. Keyed DAM Fixed Unblocked File to Non-DAM File 

The DATA routine treats the whole keyed DAM input block as a logical record. When 
defaulting output record length, the DATA routine computes a record length equal to the 


DAM record length plus the DAM key length. The output record is logically equal to the 
input block. 


Input DAM Block 


KEY DATA 


Output Record 


KEY DATA 


The KEY in the output record is used to show only the portion of the output record that 
represents the DAM input block key and has no relation to the actual record key in the 
output file (if one exists). 


2.2.2. Non-DAM File to Keyed DAM Fixed Unblocked File 
The DATA routine creates a keyed DAM block from each input record. When defaulting the 


output record length, the DATA routine computes a record length equal to the input record 
length minus the output key length. 
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Input Record 





KEY DATA 


Output DAM Block 


KEY DATA 


The KEY in the input record is used to show only the portion of the input record that is 


used as the DAM input block key and has no relation to the actual record key in the output 
file (if one exists). 





2.2.3. Variable Blocked ISAM File to Non-ISAM File (Except DAM) 
Since the variable record descriptor word for ISAM records is two bytes shorter than the 


record descriptor word for the other OS/3 file types, the DATA routine creates an extra 
two bytes in the input record descriptor word. These bytes contain X‘O0O’. 


Input ISAM Record 





DATA 


Output Record 


DATA 


2.2.4. Non-ISAM (Except DAM) to Variable Blocked ISAM File 


In this case, the conversion is the reverse of that described in 2.2.3. 


2.2.5. Variable SAM/MIRAM/Tape File to Variable Unblocked DAM File 


The DATA routine considers each input record as a DAM block; consequently, the 
following conversion is made. 
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Input Record 


RRxx KEY DATA 


Output DAM Block 


- 


BBxx denotes the block descriptor word that must be allowed for in the output block area. 
The BB is provided by data management. The xx is required by data management and is 
blank-filled by the DATA routine. 





The key length used is the key length of the DAM file. If the key length is zero, no move 
will be made and the whole input record will be treated as data. 


The KEY in the input record is used to show only the portion (if any) of the input record 


that is used as the DAM output block key (if any) and has no relation to the actual record 
key in the input file (if one exists). 


2.2.6. Variable Unblocked DAM File to Variable SAM/MIRAM/Tape File 


In this case, the conversion is the reverse of that described in 2.2.5. 


2.2.7. Variable Blocked ISAM File to Variable Unblocked DAM File 


This conversion is physically identical to the conversion of other variable records to a DAM 
block except that there are some logical differences. Also, the DATA routine ignores the 
fact that the ISAM record descriptor word (RR) is only two bytes. 


Input ISAM Record 


KEY DATA 


Output DAM Block 


— 
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BBxx denotes the block descriptor word that must be allowed for in the output block area. 
The BB is provided by data management. The xx is required by data management and is 
blank-filled by DATA. 


DD denotes the first two bytes of input data record. These bytes are moved intact to the 
third and fourth bytes of the output record descriptor word. 


The key length used is the key length of the DAM file. If the key length is zero, then no 
move will be made and the whole input record will be treated as data. 


The KEY in the ISAM input record is used to show only the portion of the record that is 
moved to the key field in the DAM block and has no relation to the ISAM record key. 
2.2.8. Variable Unblocked DAM File to Variable Blocked ISAM File 


In this case, the conversion is the reverse of that described in 2.2.7. 


2.3. OUTPUT LISTINGS 
The DATA routine provides output listings in two forms: 
s Listings of output data in different formats. 


= Automatic display of the file statistics for your job’s primary files (INPUT1 and 
OUTPUT1/INPUT2) at termination. 


2.3.1. Printer Formats 


The DATA routine can produce printed copy output in two formats: display or list. By your 
selection of keyword parameters in the Uio statement, you can designate which format 
you prefer and whether the character mode should be EBCDIC or hexadecimal. 
Hexadecimal displays require twice as many print positions as the same data displayed in 
EBCDIC. Figures 2-3 through 2-8 show examples of the display and list formats. 


2.3.1.1. Display Format 


The first 20 print positions of the first line contain column headings; the remainder of the 
line shows the position of each byte. 


Subsequent lines show the physical location and size of each block and record, as well as 
the contents of each byte. The columns, record number (REC#), block size (BLKSZ), and 
record size (RCSZ), represent the following: 


Column Description 





REC# The number of the record relative to the first record of the file. All 
records are numbered starting with 1. 
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® Column Description 


BLKSZ The input block size; i.e., for fixed-length, nondisk files, this 
number is taken from the b portion of the A keyword parameter 
(A=(r,b)). For disk files, this number is taken from the VTOC. 


For DAM files, this number is equal to the sum of the input key 
length plus input data length. 


RCSZ The output record size; i.e., for fixed-length SAM, IRAM, or ISAM 
files, this number is taken from the r portion of the keyword B 
parameter (B=r,b)). 


For DAM files, this number is the output data length. 
For variable-length SAM, ISAM, or MIRAM output files, this 
number is the record length given in the first two bytes of each 


output record. 


Figures 2-3 through 2-5 are examples of the display format in EBCDIC and hexadecimal 
modes. 


REC WO Viiv ve s8l. eectenee c20, aecescwe%O. ceceecueS) Gaeieece sD: siseeeeae6O cea'eeeec?O esoeceesOO: ecaees'e 
993399018 MIRANKEYOL M TRAM KEYO? MIRAMKEY31 RIROMKEYOL MIRAMKEYO] OATA RECOR OF 
cceccao2 PIRAMKEYC2 PIRSMKEYT? RIRAMKEYC2 MIRAMKEYO2 MIRAMKFYO2 DATS RECOR D2 
p997399033 ATRAMKE YU MIRAMKEYO*® MIRA*KEYI3 MIROMKEYO3 ALRAMKEYO3 Data RECCR O3 
cocecacs PIR OMKEYSS PIR SAKEVC® MPIRAMKEY TS PIROMKEYS® MIRAMKEYOS Oats RECOR O08 


003390005 MIRAAKEYOS MIRAMKEVOS MIRAMKEYI5 MIRAMKEYOS MIRAMKEVOS DATA RECOR OS 
cacccacs PIR ARKEYGE PIRIMKEYCS MIRAMKEYSS PIRAMKEYOS6 MIRAMKEYOS DATA RECOR 06 
00930097 MIRAMKE YO? MIRBMKEYOT MIRAMKEYI7 MIRAMKEYO? AIRAMKEYG? DATA RECOR OF 
caccco%s PIRAMKEYSS PIRSMKEYCS FIRAMKEYCS MIRSAKEYCS MIRAMKEYCS DATR RECOR 08 
83339099 MIRAAKE YOO MIRAMKEYOO MIRAPKEYID RIROMKEYS? MIRAMKEYO?S DATA RECOR 09 
CcOcccons PIRAMKEYE® PIRSMKEVIC MIRAMKEVIO RMIRAMKEYID RIRAMKE VEG OATA RECOR O19 
a0399005 MIRBAKE VEO MIRAMKEY2O MIRAPKEYIS MIRAMKEYE2 MIRAMKEYSO Data RECOR O00 
cCacecan2 PIRAMKEYI2 PIRAMKEVI2 PIRAMKEYI2 MIRAMKEYI2 MIRSMKEYE2 DATE RECOR O12 
90330083 ATRAMKE YES AIRAAKEYIS MIRAAKEVIS AIRAMKE YES AIRAMKEVIS DATA RECOR O83 
cocccoms PIRSAKEVE® PIR AMKEYIS PIRAMWEV18 MIRAMKE YI BMIRAMKEYI® DATA RECOR 028 
90990085 MIRAMKEY15 MIRAMKEVIS MIRAMKEYES MIRBMKEYIS AIRAMKEYIS OATA RECOR O85 

OOCC core PIRBMKEY25 PIR AM INCIO MIR AMMIXIG MIRAMKEYI6 MIRAMKEYI6 DUPLICATE RECORO 26 
60337097 MIROMKEY26 MIRANKEVI6 ATRAMMIXES MEOAMKETIO MIRAMKEYI6 DUPLICATE RECORD 16 
cocecoms PIRAMKEY] 7 PIRAMMEYVIT MIRARMKEYIT MIRAMKE YT? 7 MIRAMKEYI 7 MER#M RECO RO 17 
00339009 MIROSAHE VIS MIRAMKEYES MIRARKEYIS MIRAMKEVIS MIRAMKEYIB MIRAM RECO RO 18 
eectac20 PIRSAKE VES PIRAMKEYS9 PIRAMKEV 29 MIRAMKEYI9 MT RABKEYT9 MERAM RECO RO 19 
80330028 MIRGAKEY20 MIRSMKEY20 MIRAMKEY2G AIRAMKEY29 MIRAMKEY20 MERAM RECO RD 20 


“ 





Figure 2—3. EBCDIC Mode Display Format 
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RFe RO 
33739998 


319933932 
93733373 
23333098 
37333095 
99739797936 
33733047 
9313393A 
32939999 
29739909 
39399008 
33233012 
30739073 
99339784 
99979005 
903979984 
90999907 
003999988 
00373019 


00330029 


90339028 


FLKS?7 
333414 


ITAT 
229a7 
33989 
337814 
3732304 
DIIAD 
23987 
dIIAY 
33387 
337A 
FIIARG 
393949 
3934% 
33384 
JIDAY 
223484 
JIIAY 
303A89 
39789 


320987 


Vevsececki 
JICHCOACEFF 
ROCTAZERLY 
ACOCOICEFF 
eOGPa2ERL2 
acorn IceEre 
SOGTAP ERY 
NCOCOICFFE 
acogagtacy 
OCOCDICEFF 
agcyartace 
OCNCOICEFF 
AOGTArEAce 
OCNENICEFF 
aeCra2teass 
NCOCRICEFF 
eoorareace 
NCNTOICEFF 
ecoyarcacs 
RCNHCOICEFF 
BOSTA2SRIT 
NCACHICEFE 
aOSTR2ZERIC 
NCICNUCEFF 
acczyazeny2 
ACNFONCEFF 
8952825813 
OCNCOSCEFF 
US TEQERDS 
NCOCOICEFF 
WOSTRPERIE 
ACOCNACEFF 
Bosparta2’ 
OCNCOICEFF 
aogre2ee2e 
OCOCOOCEFF 
aooza2tars 
NCOCOICEFF 
eeara2aie 
ocncoacerr 
ROOTRZERTS 
bcOCcoaACEFF 
aOTarEa2c 


eeeeces 220 
OCOCONCEFF 
a9GPE25ACI 
JCACONCEFF 
BOSTAPSRC? 
OCDCDYCEFF 
AOSPRPSHCS 
OCOCHOCEFF 
BISTRIZ5ACE 
OCOCDNCEFF 
a9STRI5ARCS 
OCOCONCEFF 
BSSTHP5ACE 
OCOCONCEFF 
aQSTE75RC7 
OCOCDMCEFF 
S9STRISATR 
OCOCOUCEFF 
a9S1T825KC9 
QCUOCOUCE FF 
a9S7875897% 
OCNCONCEFF 
a95Te25AIC 
OCcOCONCEFF 
S9STR25R92 
OcOCONCEFF 
BOGTHOSATR 
NCOCOUCEFF 
ROSTR25E98 
OCOCNOCEFF 
8951825095 
OCOC OCUCFF 
0957895816 
OCOCODCEFF 
a9STH25ATS 
OCOCOUCEFF 
4997875817 
DCOCOBCEFF 
BOGTRISAISB 
OCOCOaCEFF 
R9SINPSAID 
ococonceFrr 
8957875820 
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soeseeee td 
OCOCODCEFF 
ROSE ATS P 
NcocoocEFe 
aO91875eC2 
TCOCONCEFF 
AUITETSRZTS 
NcoOcoOce FF 
9991875878 
OcOCcOncEFF 
SOOLOPSRTS 
OCOCONCFFE 
MOGTAPSALE 
GCOCOACEFF 
MO9DA25AC7 
OCcOCUNCEFF 
8991875ATB 
ACOCUOCEFF 
B°9T82SPCO 
NCOCONCEFF 
99912875810 
ACOCONCEFF 
B9O9TaPSRIC 
OCHCuNCEFF 
8991825832 
OCOCONCEFF 
4992875813 
OCOCODCLFEF 
49914875818 
OCOCONCEFF 
8993825835 
OCOCOOCEFF 
8992889716 
ACOCODCEFF 
@99T8N9716 
OCOCONCEFF 
9992825817 
OCOCONCEFF 
ag991a7sais 
OCOCOUCEFF 
4991825819 
OCOCONCEFF 
9991825825 


secccee eh 
OCOCOACEFF 
e997 arses 
OCOCOOCEFF 
@9938758C2 
OcOCcOoCcEFrF 
B9VT ETS ALY 
OCOCONCEFF 
SO9TRI58CR 
OCOCUOCEFF 
$99748295805 
OCOCDOCEFF 
997875 8L6 
UCOCONCEFF 
9997875aG? 
NCOCOOCEFF 
agora75aua 
NCOCONCEFF 
8997075809 
UCcOCUICEFF 
89974875819 
OCOCUICEFF 
4990495817 
OcocUGCEFF 
997825822 
OCOCUOCEFF 
B9I9THMSALT 
UCOCONCEFF 
A997 75418 
DCOCUUCEFF 
0993625895 
oOcocuocEerr 
0997475816 
OCOCDNCEFF 
8997 R75816 
OCOCONCEFF 
a997a75 817 
OCOCUOCEFF 
0997475818 
QDCOCUOCEFF 
8997825619 
OCOCDOCEFF 
8997875825 


weeneceedy 
OCOCOUCEFF 
a9S7425"0) 
OCOCOOCEFF 
aosra2secz 
GcOcoOoCcEFF 
a9Sta25 NOR 
OCOCOUCEFF 
89512425808 
Ococouce Fr 
a993az5e0s 
OCOCDOCEFF 
8951975906 
OCOCODCEFF 
BIGTEPSACT 
OCOCOOCE FF 
89594275°CB 
OCOCOOCE FF 
B9S*H25 ECP 
GCOCOOCE FF 
aySta2sety 
OCOCOOCEFF 
adSTS75eAbL 
OCOCOUCEFF 
ROSTHP5PIZ 
OCOCOOCE FF 
8957475R1% 
DCNCUUCE FE 
AGUSTHOSPlLS 
OCOCDOCEFF 
BOSTa2° E75 
OCOCOUCEFF 
RISISOSPLO 
OCOCOOCE FF 
aOStEP5 ALS 
OCOCOOCE FF 
BI9TEDS PLT 
OCOCODCE FF 
a9G67H>5SATR 
OCOCOOCEFF 
ags7a25e19 
OCOCOOCE FF 
agsra2se2c 


eecesee cb S 
ccecseccoo 
82137A95%69 
ccecsoccoo 
8139095369 
ccecstccoo 
813109569 
cceceoccoo 
8131095369 
ccecsoccoo 
9132095369 
ccecsoccoo 
8131095%69 
ccec soccoo 
B1ISIOMwWO 
ccécsoccoo 
81317095369 
ccec soccoo 
813TUI5S OO 
ccecesoccoo 
8137095369 
ccec sQccoo 
BIIICWIS WS 
ccecsoccoo 
8131C95 769 
ccecsnccuo 
®813°*C95 70° 
cceca0ccoD 
BISINGS OS 
ccecsoccoo 
8231095369 
CEQOCCCE CS 
S&73931I5—C 
CEVOCCCE CS 
SS7TIOIIISC 
ococoOavcco 
S99T8C9O536 
ococosucco 
89918T9536 
ococosecco 
SIWTSSISTS 
ococosocco 
8991899536 


Figure 2—4. Hexadecimal Mode Display Format 


+070 
CF aaheagaga 
#199¢¢c 000 
CF RReaaaga 
a?ancccocs 
CF SNOB a gaa 
4397925000 
CE ARRR Raa 
asacs¢2000 
CF OaRganaa 
8500963000 
CF agne nga 
8697763000 
CF Rgenaaay 
870"¢CC 000 
CF SSgRnnay 
asacccacoo 
CF RSRRhaRR 
aon--csoce 
CF FSRaaagy 
a99ccSC000 
CFF aaaagaa 
s10cC2u000 
CFFERRR RRR 
8125635000 
CFF RRR RRR 
®130955000 
CRE GRR RGR 
arecccz000 
CF FaRRagaR 
8157950000 
DCCDOCAFFS 
95369851 60 
Occoocerrs 
9536947760 
OCAFFR ROR 
°90r7CC 000 
NCOFFR Reese 
971807000 
OCH Faaaae 
98019CS000 
DOCSFFRSgay 
9802CCC000 





2-14 


eeerrey |: 
ROR angnne 
ceoococ00c 
Orrirrery yy 
eoocoocc0n 
rrrrtty tty 
caccon0009, 
GEOR nanasy 
ocococo000 
WVOn anges 
coasoo000s 
ROeaagaans 
ccoco00000 
Saanenagas 
ecooco00ce 
ORR enanas 
cootoo0cos 
Raeeaanans 
cooo0000ca 
BSReannnay 
oo0c000000 
Pry TTTT yi 
0000000000 
rrr) 
acoaco000a 
EY Erry cr! 
0000000000 
PIyyerreryy 
eoccco0000 
Prt rey 
eco0000000 
revert rty t) 
coocccooco 
rrrriit ty 
6000000000 
rrrirerr ey) 
oca0000000 
rere y ty! 
oc00000000 
irre! 
0000000000 
Ahan nnanay 
0000000000 

















UP-8069 Rev. 9 SPERRY UNIVAC OS/3 2-15 
DATA UTILITIES 





RFC NO Beceeseede esevesse2O coverces TO ceceese eh? cereeees5& sevnses sh ecccceve?D sseevseeBO 
09939998 MERAMKE YOR MERANKEYCT MIRAPKEYD2 MEROMKEYSS ALRAMKEYOL OATS RECOR DI 
CCOCPCCEFE BCOCODCEFF OCOCDDCEFF DCHCOOCEFF OCHCOCCEFF CCECABCCOD CFRARGARRR HER QRARRRR 
ROIESPSAIL BIITHEAISATY 4991825871 4999825891 A99ES25801 8231995367 8199000000 0000000000 
cocecace FIRARKEYC? PIRARKEYC? PIRAMKE YS? RIROMKE YC? MIRAMKE YO? Calta RECOR D2 
OCOTONCEFF HCOCOUCEFF OCOCNNCEFF OCOCOOCEFF OCOCOOCEFF CCECRDCCOO CFaaq Qh FUER RR EERE 
MOCTRZERT2 MOGTRI5AC? AIGTH2SAT2 8997825HC2 89691825202 84331G95369 S200CC5000 aC0ND0000E 
99939993 MIRAMKEYSY WERAMKEYO? MIRAMKEYD3 MEIRSAKEYOY SIRAMKEYO3 DATA RECOR OF 
CCOCNGCEFF OCOCGOCEFF OCOCDOCEFF OCOCDOCEFF OCNCOOCEFF CCECADCCOD CFA Ra Kaa ae EER QRgnnasa 
B991G265RI3 VIPEG2SBT3 8991925873 8999825893 3991825803 $131995369 8199999000 0000000000 
coccecca PIRPMKEYTS PIRIMMETCS MIRAMMEY SS RIROMNEYSS MIRSMKEYOR DATs RECOR Ca 
ACOCDACEFF OBCOCOICEFF OCOCOBCEFF OCOCOOCEFF DCDOCOUCEFF CCECaDCCDD CF SNQngggy BEanggnanya 
BOSTRDERTH BIGIRISACR AIGIS7ASBCe HOGTRISHOS BISTH2Z5BO4 HI39D95369 889™“FC O00 0000000000 
70339035 MIRAMKEYCS MIRON KEYS5S MIRAPKEYIS MIRO@MKETIS MIRA MKETOS DATA REC OR 05 
CCCEOCCEFFS BDCOCOGCEFF DCGCODCEFF OCECOOCEFF DCOCOOCEFF CCECROCCOD CFS RR kage HERR RRRRRG 
89IPE25AL5 BOITE25AGS 8992825835 A899T4FI5HO5 AFILS25FOS5 8131095369 2500390000 0000000000 
PIRSPKEYC# PIRAMKETCSO MIRAMFEY 76 MIRORKEYOR MERAMKEYOO DAT# RECOR 16 
DCOCDACEFF DCOCOUCEFF NCOCONCEFF UCOCOOCEFF DCDCODCEFF CCECRDOCCOD CFRSRR gage Gnaanaganny 
MOORAZESCE 953825866 S991 NZ5ALE 89998R7258I6 S9SERZ5POS 4132095369 86OTLES ONO aooD0N000ND 
99939077 33 MIROMKET3? MIRSMKEYO? MIRAMKEYIT MIRAMKEYO? MIRAMKF YO? DATA RECOR OF 
CCOCOLCEFF OCOCOCCEFF OCCCODCEFF NCCCOUCEFF OCACOOCEFF CCECADLCOD CFR RAR RRRR BRRRRaggay 
BV9TE258ST BIOLS2Z5A07 8991825897 4999825897 8999825297 81391995369 8799090000 0000000009 
earreaca 3 PIRAMKEY7E PIRAMKEYCS PIRAMKEY"S MIROMKEYOSR MIRABKFYCR O4TS RECOR DA 
OCOCOICFFF DCOFOICFFFE OCOCOOCEFF DCDCDOCEFF OCDCOUCEFF CCECSOCCOD CF BARR RRR GEER Ragnan 
ROCPRDERTE B9STHP5RCA 3991825R58 899707258CR 8YITH25CCH 89329595369 889759000 CoCd000000 
F2999999 ? MIR@MKEYI9 MIRSHKEYC? “IRAMKEYI9 MIRAMKE TOD MIRAMKEYI9 Data RECOR OF 
CCOCNCCEFF BCOCOCCEFF OCOCODCEFF BCOCOOCEFF OCOCOOCEFF CCECROCCOO CFR kggaaase gnagnnaaay 
B899TR2I5RI9 8991875899 899148258%9 8998825899 8991825899 4131095369 8999993000 0000000099 
cecrcow nS TR: PIR AMKEYIC PIRARKEYIC PIRAMKETIO PERSMKEY?? MIRAMKEYIC O8T8 RECOR 019 A 
OCOrOXICFFF BCUCOUCEFF OCOCONCEFF OCOCOGCEFF DCOCOUCEFF CCECROCCOD CFF SRA ane BRENnagara 
BOCTAQEATC A9S3R25R10 89OGIN2P5A1N 8999425819 AIGTS25ETL 8339095369 8INCSCCO00 doOCOR0N0NN 
39997901 MIRSMKE VID MIRAMKEYIO MIRAPKEYI9 MIRAMKEYED MIRAMKFY ID Data REC OR O89 
CCOCOCCEFFS OCOCOLCEFF OCCCOOCEFF GCMCOOCEFF UCOCULCEFF CCECRDCCUU CFF AR aan gy RRagegagay 
BOITE2PEBIG B991H25A10 6991925819 499919765819 S99EA25HIG 48239795369 8830007000 ad0000000Nn 
carecaor ¢ PURSPKEYI2 PIRAMKEVI2 MIRAMKEYI2 MIRAMKETI2 MIRAMKE YI? DATA RECOR O12 
OCOCONCEFF DCUCDICEFF OCOCONCEFF OCOCOOCEFF OCOCUUCEFF CCECSDCCOD CFF aqRn gas ug agggary 
SOCTA2SBI? 895TH25B12 2991925812 8999425892 8957825892 2139695369 BIZICCCOCO 0000000000 
037339084 RIRAMKE VET MIRAMKEVIS MIRAMKEYE3 MIRAMKEY13 MIRAMKEY ES OATA RECOR O13 
CCOCOUCEFF OCOCOOCEFF OCOCOOCEFF OCOCCOCEFF OCNCODCEFF CCECSNCCOD CFFS am agnn 4angggngay 
SIITE2SALS BIIZN25ALTS AF9FLOZSATS 8992825813 899TKZ25HES 4238095369 $139909000 ao00000NNN 
cocccois PIRAMKEVES PIRIMKEYIS MIRAMKEY IS MERSMKE VIS MIRSMKE YI OATS RECOR 018 
OCOCONCEFE BCOCONCEFF GCOCDDCEFF DCDCOOCEFF GCOCOLCEFF CCECHOCCOD CFFRRR RRs 4QRangnnag 
BIOTAPERRG KOGTR>OSHIS B9FIR75BIS AF9FHZSHIA AISTHA5AL A RI3TO95SEO BTANNCCOOO COOQDD0000 
00799085 MIRAMKE VIS MIRAMKEYIS MIRS*KEVI5 MIROMKE VIS MIRAMKFYT5 Oata RECOR O85 
CCOCOGCEFS OCOCOGCEFF OCOCOOCEFF OCOCDOCEFF OCOCOOCEFFE CCECAOCCOD CEFR RR RRge Qaagananan 
9992825815 89992625815 8991825815 $999425815 8991825825 9132095369 8150000000 6000000000 
COCK COsS PIRPAKEY25 PIRIMINGIG MIRAMMIXIO MIROMKEYI6 MIRAMKEYS6 CUPLICATE RECORD 16 
OCOCORCFFFE BCDCOCGCFE DCOCODCEFF OCOCUOCEFF DCOCODCEFF CEDDCCCECS DCCOOCAFFS BAnnegnans 
AOUPR2SAZE AISINGISHIG BOGIRAITIO 8993475816 89STH25816 8473931 I5C 9536990160 Coocoo000L 
00000017 MIRAAKE V2 MIROAKEVIG MIRAMMIXES MIRAMKEYI6O MIRAMKEYI46 DUPLICATE RECORD 26 
OCOCDOCEFS DCOCDOCEFF DCCCOOCEFF OCOCODCEFF OCOCOOCEFF CEDOCCCECKE OCCODCSFFS 9999 8ahngy 
QOPLEZTEZS SIPLSZSHIS BIOILESITTS BIFINI5HLG AVFISZSAIS 4973931359 9536900160 0000000000 
oocccoss PIRMAKEY?D PYRAMKEVIT FIRAMKEVI? BIRSMKEVI? ATRAAKE YS 7 MIR|RM RECO RO 17 
OCOCOBCEFF DCOCDOCEFF OCOCOOCEFF OCOCODCEFF OCOCOOCEFF DCOCOSOCCO OCAFFaRaRs Eagganaane 
SOOTAZITI SOTISZSETT 4991825827 9997925837 8999925837 8999969538 9901700000 000000000 
90090029 MIRAMKETIS HIRAAKEYIS BIRAMKEYIG ALRAMKEYIS MIRAMKETIA RIRAR RECO RO 18 > 
CCOCOOCEFF OCOCOOCEFF NCECODCEFF OCOCLUCEFF OCOCOUCEFF OCOCDAUCCD COUR FARRER PEE EE LILES 
SIOEBPSBIN APIEB25BIA 89FLE2I5ALB SIITRPSHIA 899TG2581B 8991459536 9832833000 DD0000000N 
cercces20 PIRAPKEYIS PIR AMYKEY?TD PIR AMKEYI9 MERAMKE YTS MI RAMKEYIS MIRAM RECO RO 29 
OCOLNICFFFE UCOCONCFFE OCOCONCEFF OCOCUNCEFF DCOCOICFFF OCOCOSOCCO OCOFF Raggy BORA kaag 
ROODAZEAIS AOSTAZ5HIF GO91H75HI9 499VE75H1F BYSTH75PTO B9YTKT9S5%H 9431905000 0000000000 
00599071 MIRAMKEY27 MIRSMKEY23 MIRAMKEY27 MEROMKET2) MIPAMKFY 25 MERAM RECO RO 29 
CCMEOLCEFE OCOCOCCEFF NECCOOCEFF ACHCLOCEFF DCOCUUCEFFE OCNCORGCOD CCOFFS RRR ey HOR RKaRagy 
89910245823 899L825320 299142582) 8991875823 8992825220 4991839536 9892003000 0000000000 





Figure 2—5. Combination of EBCDIC and Hexadecimal Mode Display Format 


2.3.1.2. List Format 


The list format displays your files, byte by byte. When you request the list format in 


combination EBCDIC and hexadecimal, the position of each byte is printed on the following 
line. 


Figures 2-6 through 2-8 show examples of the list format. 


UP-8069 Rev. 9 SPERRY UNIVAC 0S/3 2-16 
DATA UTILITIES 


RIRAQKE YOLMT RAAF YIUNTREMKEYTIMTRAMKEYDINTRAMKEYILOATA RECORDY 





MIRAPKE VOZRIRAMK EVC2PIRAMKEVCOMPIRAPKEYSOMIRAPKEYG2UATA RECORD? 
MIRAAKEYOIMTRAMKE VS IN TRAMKE OSM IROMKE VIIMIRAPKEVOSOATA RECORDS 
AIRAPREVOQR TRAAK EYCAPTRAMKEYOSMIRAPREYTRMIRAMKEYCADATS RECORDS 
ATRAMKEVOSMIRAMKFEYOSMIROMKEYOSMTRAMKE VISMIRAMKEYOSOATA RECORDS 
WIRAPKEVOERIRAMKEYCEPTRAMKEYOCOPRIRDPKEYCOCMNIRAPKEYCOOATS RECORDS 
MIRAAKEVOTMIRAMKFEYITMIRAMKEVITMTRAMKE YOTMIRAMKEVOTOATA RECORD? 


MIRAPKEVOERIRAMK EVCPRIRAMKEYOSRIRDPKEYOAMIRAMKEYC8DATA RECORDS 
RIRAAKE VOUMTRAMKE YI ON TRAMKEYOOMTRAMKE VIOMIRAYKEYOODATA RECORD 
MIRARKE VICK IR ARK EVICPIRAMKEVIOMIRAPKEVICMIRAPKEVICOATA RECOROIU 
ATRARKEVEIATRARKETECMIRAMKE TEIN ERAMKE VIECMIRGPKET? JOSTA RECORDID 
RIRAAKE VE ZPIR DAK EV IPP IRAMKEVIDPTIRAPKEVIQMIRAPKEVIZ0aT A RECOROI2 

WI RAAKEVESMIRAAKE VE TATROMKE YY IMPRAMKE YESMIRAMKEVISDATA RECORDIS 
WIRAPKE VI AM ITRAMK EV ERP IRAMKEYVISPTRAPKEYISMERAMKEYIGOATA RECORODS 
RIRARKEVISMIRANKFYESMIROAKEYISMIRAMKEVISRIROMKEVISOMTA RECOROIS 
AIMARKEVZEMIRAMINC TEM TREMP IXIGHIRAPKEYVI AMIR AMKEYIOON PL TCATE RECORD 26 
MIRARKEY 2ARTROMKEYUARIROMRIXIOMIROMKEYTIOMIRAMKEYIANUPLICATE RECORD 16 
PIRAPKE VI IM IRAMK EV TIP TRAMKEYIIMIRAPKEYITATRAPKEVITATRAM RECORD 27 
ATRAMKEVASMIR MKF YERMTRAMKETUGMIROMKE VISMIRAMKEYORMLRAM RECORD 18 
WIRAPREVIGMIRAMKEVIGPTRAMKEVEISHIRSPKEYISMIRAMKEYSORIR AM RECORD 39 
MITRAMKETQINTRAMKEYOIMIROMKEY2°MTRAMKE Y2IMIRAMKEY2IMTRAM RFCORD 20 





Figure 2—6. EBCDIC Mode List Format 


Ve ccccclel Coccccccerrccccc cect eer ses erties nase en een sasch oe nesses Ma cssesveh™ 
OCNCDOCEFF DCOPNNCFFEDCOCOOCEF FOCOCONCEFF OC OCODCEFFCCF C&8OCCONCE SRNSR AAA ARR RRNERAG 
BODTAZEADINGOTOPSALIAVITN FEAST AIITE SRS PA IIPHISAC EOD SIC SS VOONTS TCL5 595085 37CO6L 
Lecce wcedBecaccenePJeneccrvetVesseeesehioscencsed Mave 1 0b9ee ee as 
NCOCCOCEF FC CHCONCEFFCCRENCCEFFOCOCOOCEFFOCOCONCEFFCCEC® CCCCOCE SOO GRaagnaanag 
89978 2580799918 258728990 82 58029992 425924999 R25HI24E E795 3698 23 IIII IIITIIIVIDW 
es | ee Pe rrr: Deer rr rr! reer rrr Sere errr, errr e errr eee eer e ry 
OCNCOOCEFF NCOCONCEFFNCOCONCEF FOC OCONCEFF DC OCDDCEFFCCE CAO CIN CE AR S4R RGR Qh bay anaga 

POPSAOPOSDPAP SAC IAVGTHTSAGVRIINN I SAL VG ODPHISAC IBISIC G5 TOOK IMMICCGUCUCTCI7L90U9 
RPocrwc center cccncsPlavne creates crsseehiasececeed Vase eb Ve cccccce Meercnee 08S 
NCOCCOCEFFOCCCOOCE FFCCOCOCCEFFOCOCOCCEFFO COCUOLCEFFCCECALCCUOCE SAS AN SAAR RAGA Aa Re 
89978 259080991 675 AL88 994 G2 42H H 99TH 75K IO BI 91H P5898 OE SE N95 3699899059 99999 De IOI 
VDoc veceeblewcecccesisnerasee te cesec eed eee csser cesses er sb eeascceetdcseeeesshs 
OCOCDOCEFF NCOCHNCEFFNCNCOOCEF FOCOCDNCEFF DC DCODCEFFCCE COUCCONCE Gana aan ana aaggane 
RSVP APSROERIIDR? ERC TASS INTSPCSSIIPGPSAC ER IFPR ISAC SAE IIC IS HORST OCC OSCE CSS WESE 
Dower wend dencccccet Meccc creates acc ered ran cnssee dees sense descesses lsecveece 087 
NCOCCOCEFFOCCCEACEFFOCNCOLCCEFFOCOCOCCEF FOCOCODCEFFCCECS CCCENCE ARABS Oh aR RRA ga nags 
89978 25894 0992 8259940999 87 5AI4G9918 25836 O99TRP5SADOME SEF 5 869969 9II9I99II III IIIA 
Peery es Tee eee eee eee Peres eer ee ere. Pee ee eee hl See eee Cee ee ere eee eee 
OCNCONCFFF OCOCONCFF FOCOCOOCFF FOC OCONCEFF OC OCOOCEFF CCE CUD CEINCE AGORA AAR ARG GHAR ans 
R991 A25AD PAGITAISAC TASS PRT SPC TASFTAPERL TRODIUPSAC IMI SIL SS VOOR IF IGEC IGE SE ST COLO 
Pec weed docccnccarVeccevecattevesesreedoecscese dees ese seb densseereliseeceas BD 
NCNCCOCEFFOCOCOOCEFFOCUCOCCFFFOCOCLOCEFFOCOCODCEFFCCE CA LCCCUNCE SAS SRNR RRQ Oaasagns 
490282588 099182587 A8 998 6258788991825 80889 92875808481 1219536988 9ITITIIIIIIIVIIGG® 
Porc creel le weccnee Mowers seeder ees aeWig ne sssserisscoesssblicereseeslOevesee es Bl 
OCOCDOCEFF DCOCONCFFFOCNCONCEF FOC OCUNCE FF OC OCODCEFFCCE CAO CCONCE 88S SR RRR RRQ Ranga 
ROOT APSROSOSIPAPSACONGS TN ZSACOROGT HISAR SANGVPRASMCORNT IVE GHMEOMINGOCCSUCSCOCACOLC 
PETERETE PISEP PETES Te eEEEECISEESEEEL OCR TOPE eRe ee tee ss eee e rere ee ee, 
NCOCCOCEF FOCI COOCE FFECNEACCEFFOCNCLOCES FOCOCOOCEFFCCECS CCCONCE FAS RRR ha ange 
09918 2581789918 2588 199918258198 9984258158999 758996 307953698 29 30I9 399 IIIIIIIANGD 
Vewawce ed la wnwc cee rlcccne cen cartes eaten ssc as eer ces sae assbGsesesseelCesseee es BO 
OCOCOOCEFF OUCOTAACFFFOCOCONCEF FOC OCONCEFF DCOCOOCEFFCCE C80 CCOOCFE S88 OR RR Gna an ae aay 
BOOVAPSAECRIOTAPSMITAOSTH TS OT AGOTSPEPLCAIITMPSARTOL SIC SS VO9AI MNCL SSGSL ACC ICOCS 
Pewee ceatdocccccca rie cnc cc cers cse reed TesvenseesVoecere ssODeensseeetieveeese 889 
NCOCCOCEFFOCHCOOCEFFCCOENICEFFOCOCKECCEF FO COCODCEFFCCECS COCOOCE FASS GMa Rh RAR Ra aaay 
829998 2581209998 2580 28991 824A 1289918 25AF 289928 25BF 240 38995 FA 949 29009 I9IITIIVIAIND 
Vero eveald CocccccseDlesans rae eas cre sed eveseessrcecesase sbGsene eT eee eee 8D 
OCNCOOCEFF NCOCHNCFFFNCOCONCEF FNC OCOUCEFF OCOCODCEFFCCFECSOCCONCFE G88 GARR RNa gee aan 
AOVIIAZSADINAGITSPSAPTAGITR PEPE IAIGTU EAL IBGIN GD DORIGIZIC GS POCBP IMMPCCIGGCOCO*COLC 
Ve cnrceebBecwccccePMecnc cca thee sscrsehIececassed Voccers ecb envesees I0sne «89 
MCNCCOCEFFOCECCOCE FFOCOCOCCEFFOCOCGCCEF FOCOCDOCEFFCCECS CCCONCE FARK ARR aa ay aaa 
89928258 158901 2 2538E 88999 75H IRA 991 U 25H GH99L8 2589 8 OF E995 34 98 18I9I0 3999939390007 
Bowe ened lowcewcce ri onesasnatraccaes sede sases ser laseeess OC wa seesnel se vesee oeBG 
OCOCONCFFF ACACOANCFFFOCNCONCEF EACOCONC EFF OCOCODCEFFCCECSOCCONCEE ASR R RAR akan gaa age 
BOTTAPSRELATOTAPSAISSGGIBTEPISATIPNPEBT EU IPERISRPSHETBCSS VOPMT STALE ISCCCCC INO 
Voce cee b doce n cece Fe cen cee e tev ere ee addecacccre DS dene ees ach Vesveeses Tieseuses 089 
OCOCCOCEFFECECOCCCFECCOCOCCEFFOCOCCCCES FOCOCDOCEFFCEOOCECE CALCCIOCHF FUR HK enna ay 
BSIVAPSR2ASHIFLR ISBT HSIPLAAITIAGIFIIG2SSLANIILES 25 BUA NS? SF3F 35795 169814999939 39939 
w;8, 


Ro cserc ashi ccvescerien sence nb ocsccncetJacer 80 
OCOCIOCEFF OCNCANCFFFOCOCOICFE FUCOCHICEFF OCOCHICEFFCEDUCCCEC SUCCODCHF FARRAR Ragga 
RODTAPSRZEACOTAPSPPARSIIGADITOSIITS7SAL OR IGPUISADERR ISS MD ISTOSISIASPSSSCOSIOLS 
ees © err re ee rer nore Pe we Vacs cee web Danese ns Cree as 
PCNCOOCEFFERECCONCEFFEOCOENCCEFFUCOCEOCCEFFOCUCCOCEFFOCHCOSUCCIC CHF FSS suagag aaa 
BFOV825H97 4991 O2599 7H FIL B2EHT IG IIT PSB ET GIFTS PSBU PHIFER 9S 349999 799 IIT I9IIIIIII> 
es 6 Ser er kee a Se er i ia ere eT 6? 
OCNCONCEFF UCN EN ACEFEUCNFONCEF FUCA IC EEF OC OCNACEFFOCNCOSOCCHICUFFE SS ARG RG AR GAR aan 
R291 8 284194997 A 258T AG IIL MPSRIRGIYES 2597 S49 918 25HT 8 GSIIS TIS TAGE AS FI IN ITI 27997 





Pewee cee eb lee eve eeatinccsases 


es © ee es ee Sa ee aie. ee er ee ee res 10] 
DOCNZTINCEFE ACKHENACKFENCHCDICFFEICOCUICEF FE OCOCMUCEFFUCICOSNICCIO CEE FGM SG aaa gga gays 
ROFPMPSARGAIIDRPSA TPG AIGER SEP POGIE] AP FAPEKSOPEWHGEWOGHE MATOS VAIDGL PICT ICS CC lS ISS 
ees © ee Se re ioe cr er ee ee. el 
PCACCOCEF FE EPCS OCEFFOCUFOLCCEFFR COCO CEFEOCOE OSCE FFUCOCCACCCEL CAFES RGU RR ERM RR AR ye 
89998 25A7789FE A 25H? AID UPSAZTUDIDS PEK PF IAFIPRISB? SRIF NAS THAIN DIVGES PIDIIVES IIW 





Figure 2—7. Hexadecimal Mode List Format 








UP-8069 Rev. 9 SPERRY UNIVAC OS/3 2-17 
DATA UTILITIES 





Lecce ccctlenaccscattecce cere tee wenes cM eens eseS done res eehVecssssesTIneeseee ef? 
MIRAPKE TCIPIRAMK EVOPPTRAMKE YS IMIR APKEYCIMIRAPKEVCROUATA RECORD? 
DCOCOOCEFF OCOCHNCFFFOCNCOOCEF FOC OCUDC EFF OCOCOOCEFFCCECRICCONCE CRRA KRG ARAN Qn aa hye 
BAOPTAPSRETAVITAP SAC PRSSTAFSMCIRSIVETSR. SRIITRPS MC IMISEL GS VOOMECIOCSECOOCCCOICGCAh 
eccddeccnccec? Vecce ceve tes cece eh ee nceeseS dovcnce seb tevseeeset licensee aM? 
MIRSPKE VO ZR IR BAK EYC PP IRAMKEYCOPIRAPRKEV 2M IRAPKEYC20ATS RECORD? 
DCOCOOCEFF NCOCHNCEFFACNCONCEFFOCOCONCEFF OCOCODCEFFCCE CRO CCONCE ROR GRR a 4Q RGR Banga 
RIVTRPSROTAISEMPERCZASIIRTSPOINIGTAZSAC IE ODE MP SRO2ZKD IIL GS VOORITTOVG TCL ACCS SICOSe 
Pees & errr rare Serr rrr re Ute errrr’ Miter rere Le rere reer! Pre rrr re reer rer ee ey. tel 
MIRAPKE YG *MIRBAK EVO PIRAMKE YO IMIRAPKEYOIMIRSPREYCIUBTA RECORDS 
DCOCDOCEFF ICOCONCFFFNACUCOICEF FHC OCOICEFFOCOCOOCEFFCCE C8ICCONCE CURR RRR 4a 4 aR aa aay 
ROGDEAZSAG TAVITAPSRC UMIGPRZSPCSASGINTERS UH IDPOISACIMRIFI GS TOOMIIMNCC UU CEGCSCOGC 
1 wc aetBeccwcncerJecvn sees ecco s eM ies cccaseS Vaee ess web MWwonsaseetineseess 089 
MIR APKE VOOR DRAAK EYCSPIRAMKEYCOMIRAPK EY SRM IRAMKEYSRUATA RECOPOS 
OCOCODCEFF DCOCNNCFFSNCICOICEF FOCOCUNC EFF DC OCODCEFFCCE CHO CCONCE HA G4 A RRR aR a Ra aa nay 
BOSIAPSACRATITAP SMC ARGIIH TS PCRRIGPE*SBLOR IIIS PS ROARS ALIS VOORMMINGCGUVGLCET ON COLE 
Peseeacedd« ee De cee ceva tdeewoc en ee neces eee tT Iasecee cab Senne oTDescceae 08D 
WIRAPKE VO EP IROMK EYCEPIRAMKEYCEMIRAPKEYOSMIRAPKEYOSOATA RECORDS 
OCOCONCEFF OCOCONCFEFNOCNCOSCE F FOC OCOOC EFF OCOCONDCEFFCCECSUCCONCE TR ROR RRQ Ragas han 
BUPIRASADENVIDEP SAC ERIFESTSPCSAIIISPSOC TS OIIHISRCE SRE IFC IS VOVMSIWOCOUSGICOISICOUG 
Prrrrrrs Orie errr ry dere ere rr Ee errr Mice eer here) weebVecccere a Ieeeeces sBS 
RIRAPKEYGEPIRSMK EV CAPTRAMKEYCOMIRAPKEYCEMIRPPKEYSOORTA RECORDS 
DCOCDOCEFF ACNCONCEFFOCOCD.ICFFFOCOCOICEFF OCOCDDCEFFCCE CSUCCONCE OBO Raa Gag aga aan 
ROPIRPSADEASITVAPSPCESSSIOSEPSEASST AM SHOR SFIRASAC ERI IV. GSVOOMAINNGIIOUIOTIOSCOCC 
Rocce cctrecccccceMie cee coe een ences cdr oc ccanen Ts Veen ase seb VManvenses Marcas se 08D 
MIRPPKE VOIR IRAMKEYCIPIRSAKEYCTPIRAPKEYOIMIRAMPKEYCIDATA RECORD? 
DOCNCIOCEFF NCOCOACFEFFOCNCOICEF FOC OCOOCEFF DC OCOOCEFFCCECRDCCONCFE AVR RR RGR AR RRKARRasR 
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Figure 2—8. Combination of EDCDIC and Hexadecimal Mode List Format 
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2.3.2. Termination Information 





Upon termination of the DATA routine, file statistics for your primary files are written to 
the system log file or the printer file. They are written to the system console if you include 
a // PARAM DISPLAY statement (2.1.10.3) in your job control stream. When you execute 
a program in basic or mixed data management environments, the format of the 
termination information for card, tape, printer, and non-MIRAM disk files is as follows 
(consolidated data management termination information is presented in 6.3): 





a INPUT1 
INPUT1...(FILENAME).................02005 DISK 
CARD 
TAPE 
DCON4 
RECORD (SUZ EB ccveg 24 bobs pk eG eek Re. aoe eee Brine nanan 
BROCK SMNZ Ess ices 6: rete aterace no bows Bed eo Be nnnnn 
KEY: DENG UH 2th dented a ee geet tha eines Si nAnnann 
KEY: LOGAT VON acces ee bid Reta e ee wa ale A eae nanan 
RECORD FORMAT... ..... 0.0... e ee eee eee FIXBLK 
FIXUNB 
VARBLK 
VARUNB 
PGE ORGY i ie ee Rene tcc ee ean aS rye we /SAM 
Nl 
DAM 
ISAM 
IRAM a 
ee 
= = =OUTPUT1/INPUT2 
OUTPUTIL/INPUT2..... 0.0.2.2... 0. cee ee ee eee DISK 
TAPE 
CARD 
PRINTER 
RECORD: SUZ becca cccediiece ts belie nile Bwana nnann 
BEOGK. SWZEs.. ccs ie Oaceltined tae tet ote ee ate Annnn 
WEY WENG THis eee cce oto eee lots ee Od Eee oe aoe nnnnn 
KEY: LOCATION: 203... se ee oeeus pee eee ea gt nnonon 
RECORD FORMAT.............2 000 ee eee eee FIXBLK 
FIXUNB 
VARBLK 
VARUNB 
PoE: ORGS cnt She i ee ies ts Ree ae SAM 
N1 
DAM 
1SAM 





| RAM eee 
INDEX 
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@& The format of the termination for MIRAM disk files is: 


INPUTI/INPUT2/OUTPUTI...(FILENAME)........ DISK 
RECORD “SWZ Beds cecttansracd reve eed siardes eos hen ens. dosed ode nonan 
BlOCK SUZ Bes cero e OE ee Bk ev ee Waa ee nanan 
KEY ENG THe ccs sc eacccet thane Gad se Seetin ate Bae nnonnn 
KEY LOGATNON ? fc sca eal ta uae cata oe eaten a nnonnn 
MIRAM KEY Loc LEN CHG DUP 
KEY1 nonan nonnn Y/N Y/N 
KEY2 nnnnn nanan Y/N Y/N 
KEY3 nonann nnnnn Y/N Y/N 
KEY4 nanan noann Y/N Y/N 
KEY5 nannn nnannna Y/N Y/N 
INDEX BUFFER SIZE..... 2... ee eee ee nononn 
RECORD CONTROL BYTE..................000.8 ah 
ie 
RECORD (SLOT. -SUZE. osc0 ox edhe eRe ia wg Ans Bs nannn 
DUSK “SECTOR SZ Boe oe ciate Bie eR Bead annan 
VOLUME MOUNT SETTING................,.... SINGLE 
ne } 
RECORD FORMAT....................0...0 cee at 
VARBLK 
FILE ORG...MIRAM woe UNEQUAL. .nnnannnonn 
INDEX 


NOTE: 


RCDS UNEQUAL field appears only on INPUT2 termination information. 


2.4. ERROR MESSAGES 


2-19 


If an error occurs during the execution of the DATA routine, error messages are produced. 


The error messages are displayed on the printer, the system console, the system log file 


and the workstation. 

The errors are grouped into four categories as follows: 
1. Informative 

2. Warning 

3. Serious 


4. Fatal 


t 


Table 2-1 lists the UPSI byte settings for these categories. All the error messages are 
& listed in the system messages programmer/operator reference, UP-8076 (current version). 
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3. DATA Routine Statements 


BASIC UTILITY INPUT AND OUTPUT STATEMENT 


The basic utility input and output statement (Uio) is used to specify the copy or compare 
functions that you wish the DATA routine to perform. The Uio statement identifies the 
input and output devices required and describes the data format of your files to the DATA 
routine through the keyword parameters you specify. Keyword parameters allow you to 


describe: 

# the format and access method of your input and output files; 

m whether this is a copy or compare function; 

= the file locations where processing begins; 

= the number of unequal records accepted, or the number of blocks or records 
processed before DATA routine termination; 

= whether the output record is written to more than one device; 

= whether input and output tapes are rewound; and 


whether printer mismatches are ignored or terminate the DATA routine. 


To do this, you must include the appropriate Uio statement in your control stream between 
the /$ and /* job control statements following the 7/ EXEC DATA job control statement. 
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3.1.1. Input and Output Statement Mnemonics 


The utility input and output statement contains the mnemonic Uio, which you code to 
identify the types of devices you require for input and output. 


In this mnemonic: 
= U is a constant that identifies the utility input and output statement. 


® ji is a variable that identifies the input device as a card reader or 8413 diskette (C), 
magnetic tape unit (T), or disk (D). 


# ois a variable that identifies the primary output device as a card punch or 8413 
diskette (C), magnetic tape unit (T), disk (D), or printer (P). 


Valid Uio mnemonics are: 


Mnemonic — Input and Output Device 


UCC Card reader to card punch 

UCD Card reader to disk 

UCT Card reader to tape 

UCP Card reader to printer (Default option - When you copy a card file to the 
printer and require no modifications to the file, no Uio mnemonic is 
needed.) 

UDC Disk to card punch 

UDD Disk to disk 

UDT Disk to tape 

UDP Disk to printer 

UTC Tape to card punch 

UTD Tape to disk 

UTT Tape to tape 

UTP Tape to printer 


Figure 3-1 shows the Uio mnemonics and their relationship to the input and output 
devices needed to copy or compare files. 
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STATEMENT 
(Ki = COPY FUNCTION) 






(K2 = COMPARE 
FUNCTION) 















DATA ROUTINE 
COPY OR COMPARE 
FUNCTION 







CARD OR 8413 
DISKETTE 









CARD OR 
8413 DISKETTE 








STATEMENT 
(K1 = COPY FUNCTION) 
(K2 = COMPARE 
FUNCTION) 











DATA ROUTINE 
COPY OR COMPARE 
FUNCTION 











CARD OR 
8413 DISKETTE 





Figure 3—1. Relationship of Uio Mnemonics to Input and Output Devices (Part 1 of 2) 
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Uio 
STATEMENT 
(K1 = COPY FUNCTION) 
(K2 = COMPARE 
FUNCTION) 









DATA ROUTINE 
COPY OR COMPARE 
FUNCTION 





CARD OR 
8413 DISKETTE 


Figure 3—1. Relationship of Uio Mnemonics to Input and Output Devices (Part 2 of 2) 


3.1.2. Uio Parameters 


The available Uio parameters are required only when you want to perform an operation 
other than a file copying operation and when an exact copy is being performed to the 
same device type. If the input is a multiple keyed MIRAM disk, then the key that 
references the file must be specified [MKR=( )]. Table 3-1 (see 3.2.4) describes these 
parameters. 


3.2. INPUT AND OUTPUT STATEMENT FORMATS 


Different formats are available for the utility input and output (Uio) statements that 
describe the files and devices involved in DATA routines. These formats use variations of 
the same operand set, depending upon the device and access method used to copy or 
compare files. The general format for each statement is: 


Mnemonic Keyword Parameter 
Portion Portion 
OPERATIONA OPERAND 


Uio PPP. pPpPp...ppp 
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Statements start in column 1 and end in or before column 71. The statements may be 
repeated as often as necessary; they may not be continued. If more than one card is 
required, do not insert a continuation character in column 72, but repeat the Uio operation 
in columns 1-3 of the next card. 


The mnemonic portion, Uio, specifies the device type for the input (i) and output (0) files. It 
must be followed by a blank. 


The keyword parameter portion, ppp, defines the files being used and the options that are 
needed. A comma follows each parameter except the last, which must be followed by a 
blank. Embedded blanks are not allowed except with alphanumeric literals. All keyword 
parameters are optional. Default values are supplied by the DATA routine. 

The keyword parameters required by your job must be supplied on the Uio statement and 
in the form specified in Table 3-1. The complete Uio statement for your job must be 
written in one of the formats shown on the following pages. There is a format for every 
combination of input and output device types. The default options are indicated by shading. 
3.2.1. Card Input Formats 


Diskettes are treated as card files. 


3.2.1.1. Card-to-Card 


= Basic, mixed, and consolidated data management environments 








OPERATIONA | OPERAND 


(BU) 
(UU) 






,R=((nonnnnann) 
(nnnannn, nnonnnn) 













be Ht ape ‘] [ 


NOTE: 


The ORA, WPC, and WPO parameters are not used in basic data management. 
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3.2.1.2. Card-to-Disk 



































= For SAM files: basic and mixed data management environments 
OPERATIONA | OPERAND 
,R=((nonannn) 7 
(a nnn,annonnnan) 















ARITA Op A 
L 1 i") ][ © 
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= ~=6For IRAM files: basic and mixed data management environments 









OPERATIONA OPERAND 






{MAT for t= acu 







Lelia oof [ 08 (7 | 


















a ie (nnnnannn) 
DP 


: lent Teena e ef 


ee “a mt 


={(onnnnnn) 
(nnnnnonn,onnannnn) 


i 








qe] vs : 


K2 
[ 


[} { 


MY 


; 
- 


ua 


1Q= 










['Wvs—connnnytl O°” Lai 
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3.2.1.3. Card-to-Tape 





= Basic, mixed, and consolidated data management environments 


OPERATIONA | OPERAND 












,R=¢ (annnnnn) 
(nannnnn,annnnnn) 


3.2.1.4. Card-to-Printer 


= @Basic, mixed, and consolidated data management environments 





OPERATIONA OPERAND 





,R={((nnannnn) 
(nnnnnnn,nnnnnann) 





= Example 1: 
1 10 20 30 


UCT OR, Q=(2,4,1,1),R=(58),X=(2,4),2N 


A card reader and tape unit are the devices used in the operation designated by the 
UCT mnemonic. A file input in the card reader is copied into a magnetic tape output 
file. 


- Default processing 





The default keyword parameters were omitted because their default values are 
automatically assigned to the job. Omitting the A and B keyword parameters 
specifies 80-byte record and block lengths. Fixed-length records are assumed. 
Omitting keyword parameters /7 and K7 specifies that card input is in EBCDIC 
and that this is a copy operation. 








~ UP-8069 Rev. 9 SPERRY UNIVAC OS/3 3-9 
DATA UTILITIES 


- Requested processing 


Options requested, via keyword parameters, to process the UCT statement 
include: OR, which specifies rewinding of output tape before and after 
processing; OQ=(2,4,1,1), which specifies that sequence numbers be written on 
the output tape file starting in column 2, the sequence field is 4 bytes long, 1 is 
the first sequence number written, and that the sequence field is incremented by 
1 for each record; A=(50), X=(2,4), and ZN specify that processing begins at 
logical record 50, a sequence check is made on the input file starting at column 
2 for a length of 4 bytes, and leading tape marks are not written on the output 
file. 


= Example 2: 


1 10 
uCcC 


A card reader and card punch are identified by the mnemonic UCC as the devices 
used. A file input in the card reader is copied into a card punch output file. 


- Default processing 


Because the default values sufficiently describe the particular file and operation, 
all keyword parameters are omitted. The default values for the keyword 
parameters A, B, /1, K1, O17, and R specify: The input and output files contain 80- 
byte blocks and records, with input mode in EBCDIC; this is a copy operation, 
output mode is EBCDIC, and processing begins with the first record. 
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3.2.2. Tape Input Formats 





3.2.2.1. Tape-to-Card 


= Basic, mixed, and consolidated data management environments 




















OPERATIONA OPERAND 
UTC . 
j pee 
(BU) 
: (UU) 
4] se isshna siviuen) 
aie Gale ea 
YI=(i) 
YIN=(i) 
NOTE: 


The ORA, WPC, and WPO parameters are not used in basic data management. 
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& 3.2.2.2. Tape-to-Disk 


= For SAM files: basic and mixed data management environments 








OPERATIONA OPERAND 


(nnnnnnn) (Se ,§TD 
(nonnonn, ononnan) $2 [ ‘au | 
tay $3 

ty ah 


s For ISAM files: basic and mixed data management environments 
















I Sm Tigercat 
fie) gira [sill fat] CD 





1 
"OC en” Hl He ; 1 
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2 = For MIRAM files: basic, mixed, and consolidated data management environments 







OPERATIONA | OPERAND 








Fy ones es 
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3.2.2.3. Tape-to-Tape 


= Basic, mixed, and consolidated data management environments 


OPERATIONA OPERAND 





YBN=(i) 











3-14 




















UP-8069 Rev. 9 SPERRY UNIVAC OS/3 3-15 


DATA UTILITIES 


a 


3.2.2.4. Tape-to-Printer 


Basic, mixed, and consolidated data management environments 






OPERATIONA | OPERAND 





(nonnnnn) 





AY! 





,R=( (nnnnonnan) 





nannnn,annnannn) $2 YIN 
= $3 Y1=(i) 
SA YIN=(i) 


Example 1: 


1 10 
UTT 


A tape-to-tape operation is designated by the mnemonic UTT. The data on one 
magnetic tape file is to be copied to another magnetic tape file. 


- Default processing 


Because the default options sufficiently describe the magnetic tape files and the 
operation, all keyword parameters can be omitted. The default keyword 
parameters, A, B, FF, IM, K1, LF, OM, R, and ZN specify: the input and output 
record and block lengths are 80 bytes; the input tape is not rewound before or 
after processing; this is a copy operation; there are no input or output file labels; 
the output tape is not rewound after processing; processing begins with the first 
logical record; and leading tape marks are not written on the output file. 


Example 2: 
1 10 20 30 40 


UTT A=(80,98),C=(560),1L,K2,0R,R=(5,5) 


A tape-to-tape operation is designated by the mnemonic UTT. Two magnetic tape files 
are compared and the unequal records are printed. 
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- Default processing 





The B keyword parameter is omitted. By default it is assumed that the second 
input file block and record lengths are the same as the first input file specified by 
A=(80,90). Omitting the LF keyword parameter indicates that the input and output 
files are unlabeled. By omitting the ZV keyword parameter, tape marks are not 
written on the output tape. 


- Requested processing 


Input record lengths are 80 bytes long, and input block lengths are 90 bytes long 
as specified by the A keyword parameter. The C keyword parameter specifies that 
500 unequal records are accepted and printed before job termination. The /L 
keyword parameter specifies that the first input tape is rewound before processing 
and rewound with interlock after processing. K2 specifies a compare operation; 
OR specifies the second input tape is rewound before and after processing. The R 
keyword parameter specifies that processing begins with the fifth logical record on 
both input tapes. 


3.2.3. Disk Input Formats 


3.2.3.1. Disk-to-Card 





= For SAM, DAM, ISAM and IRAM files: basic and mixed data management 
environments 







OPERATIONA | OPERAND 








(UU) 
das jesepreeerrrrrn (i esrra a eamee yr Bae 
‘SA 





NOTE: 


The ORA, WPC, and WPO parameters are not used in basic data management. 
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= ~~ For MIRAM files: basic, mixed, and consolidated data management environments 











OPERATION 





OPERATIONA 
n ) 






»R={(nnannnnn) ' st 


Annnn,annnannn) $2 


ga lca ea lacie 





NOTE: 
The ORA, WPC, and WPO parameters are not used in basic data management. 


3.2.3.2. Disk-to-Disk 


= For SAM-to-SAM files: basic and mixed data management environments 


OPERATIONA } OPERAND 








# For DAM-to-DAM files: basic and mixed data management environments 
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= For DAM-to-SAM files: basic and mixed data management environments 










OPERATIONA } OPERAND 





=((nnnnannn) (RE 
nnnnan,nnnnnnn) 





=((nannnnn) Ee [ TD t] 
(nonnonn,nannnannan) $2 we 
” re: 
SA 


| toe ag it Ons. 
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For SAM-to-IRAM files: basic and mixed data management environments 


ay ie 


eT : 








OPERATIONA | OPERAND 
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= For DAM-to-IRAM files: basic and mixed data management environments 








i aller jot mdaH ate SIL, vy i aa | vi] 





= For ISAM-to-ISAM files: basic and mixed data management environments 
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@ = For IRAM-to-IRAM files: basic and mixed data management environments 






OPERATIONA OPERAND 










Naa “Vasintag TC feel 
i bell iN mail joer (ec iy SIL, — a 














,R=((nonnnnn) (8 
(nannnnan,onnnannn) 
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= For IRAM-to-SAM files: basic and mixed data management environments 








OPERATIONA 
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@ = For SAM-to-MIRAM files: basic and mixed data management environments 











OPERAND 





OPERATIONA 





aa CO) essen 





ei oe] 


MK3 
MK4 
MK5 


ik Cr) inate 32 


={(nnnnonn) ‘ $i 


(nnannnn,nnnnnnn) $2 











,§VS 1 baa 
VS=(nnnnn) 








# For ISAM-to-DAM files: basic and mixed data management environments 


(nnannnnn) 
(nnnannon,nnnannnn) 














UP-8069 Rev. 9 SPERRY UNIVAC 0S/3 3-24 


DATA UTILITIES 


For DAM-to-MIRAM files: basic and mixed data management environments 
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© = For ISAM-to-MIRAM files: basic and mixed data management environments 
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= For IRAM-to-iSAM files: basic and mixed data management environments 
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= = For MIRAM-to-SAM files: basic and mixed data management environments 
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= For MIRAM-to-ISAM files: basic and mixed data management environments 
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For MIRAM-to-MIRAM files: basic, mixed, and consolidated data management 
environments 
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= For DAM files: basic and mixed data management environments 
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For IRAM files: basic and mixed data management environments 
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3.2.3.4. Disk-to-Printer 





= For SAM files: basic and mixed data management environments 
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For IRAM files: basic and mixed data management environments 
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Example 1: 


1 10 20 30 


UDC C=(18),H=(1080),K2,R=(18,19) 


The mnemonic UDC specifies a disk-to-card operation. An input disk file in SAM 
format is compared with the card file entered from the card reader. The unequal 
records are printed. 


~ Default processing 


All disk input file characteristics are taken from information stored in the VTOC. 
These include the length of the input records and blocks, the fixed-length record 
format, and the SAM disk file. Because the O7 keyword parameter is omitted, 
EBCDIC is assumed. The length of the output records and blocks is equal to the 
length of the input records and blocks. 
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- Requested processing 


The requested keyword parameters specify the following: a maximum of 10 
unequal records are accepted and printed; DATA routine is terminated after 
comparing 1000 records (this is a compare operation); and begin processing at 
the tenth record in the disk and card files. 


= Example 2: 


1 10 20 30 40 50 


UDC B=(88,88),DP,H=(1988) ,Q=(73,8,1,5),R=(18),TD 


A disk-to-card operation is specified by the UDC mnemonic. A disk file in DAM format 
is output at the card punch. 


- Default processing 


The copy operation and EBCDIC are specified by omitting the keyword 
parameters K7 and O2, respectively. 


- Requested processing 


Taken in the order shown in the example, the keyword parameters specify: 
Output file record and block lengths are 80 bytes. Each punched record is 
printed. Up to 1000 input records are processed before the DATA routine 
terminates; sequence numbers are punched on each record of the output file. 
The sequence field starts in column 73, field length is 8 bytes, and sequence 
numbers start at 1 and are incremented by 5. Processing begins at the 10th 
record. Print is in display format. 





= §=Example 3: 


1 10 20 30 40 


UDT K2,C=(198),R=(5),Q=(1, , 868069) 


The mnemonic UDT specifies a disk-to-tape operation. A disk file in ISAM format is 
compared with a tape file. 


- Default processing 


All disk input file characteristics are taken from information stored in the VTOC. 
These include the input and output file blocks and record length, the fixed-length 
record format, and the ISAM disk file. The default values for the H, L3, and OM 
keyword parameters specify that the entire file is to be processed, the tape has 
no output labels, and the output tape is not rewound before or after processing. 
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Requested processing 


The keyword parameters specify that: This is a compare operation. A total of 100 
unequal records are accepted and printed before the DATA routine terminates. 
Processing begins with logical record 5. Sequence numbering is to be performed 
where the sequence field begins in column 1, the size of the field is 6 (by 
default), the sequence number of the first record is OO0000, and the increment is 
100 (by default). 


= Example 4: 


1 


UDD 


10 


The mnemonic UDD specifies a disk-to-disk operation. Because no parameters are 
specified, the default values are used. 


3.2.4. 


Default processing 


All disk input file characteristics are taken from information stored in the VTOC. 
These include input and output file block and record lengths, fixed-length 
records, the key length, and the key location. By default, both printing and 
punching are suppressed. This is a copy operation. The output file type is the 
same as the input file type. No sequence checking is performed and processing 
begins with the first logical record. Both the input and output are not in ASCIl. 


Input and Output Statement Keyword Parameters 


To use the DATA routine, you should be thoroughly familiar with the keyword parameters 
listed in Table 3-1. They are listed in alphabetic order with a description of the function 
and default option for each. 


NOTE: 


MIRAM and IRAM files must have the volume mount indicator set to MULTI if the file is to 
be processed randomly later. 


The following restrictions apply to IRAM format files only: 


= Key length may not be greater than 80 bytes (V parameter). 


= Records may not be of variable length. 


a Duplicate keys are not allowed. 


a Multikey files are not supported. 


NOTE: 


If any of the above requirements are not met, the job step will be terminated and an error 
message will be printed. 
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Table 3—1. Keyword Parameters for Utility Input and Output Statements (Part 1 of 11) 


INPUT1 Block and Record Length 


For fixed-length (FF) records on 8413 card or tape files, this parameter specifies record 
length (r) and block length (b) expressed: in decimal. If omitted, r and b both default to 
80. The block length b must be a multiple of r. 


For variable-length (FV) records on tape input files, this parameter specifies a 
minimum r and a maximum b. If omitted, the minimum r defaults to O and the 
maximum b defaults to 80. 


For fixed-length (FF) records on SAM, DAM, or ISAM disk input files, this parameter is 
not used. The r and b lengths are taken from the VTOC entry for the INPUT1 file. If 
this parameter is specified for SAM, DAM, or ISAM files, no error message will be 
generated but the information specified in this parameter will be ignored. 


lf DAM input is specified in the preceding case, the r represents the record data 
length; the key length is not included in r. If SAM input is specified, then b must be a 
multiple of r. 


For fixed-length (FF) records on IRAM or MIRAM files, this parameter specifies a 
dummy value less than six digits long (r) and the buffer length (b) expressed in decimal 
(b must be a multiple of sector size). If the specified buffer length is less than the 
minimum allowed for the record size, as specified in the VTOC entry for INPUT1, then 
the minimum wiil be used. 


For variable-length (FV) records on SAM, DAM, or ISAM files, this parameter specifies 
a minimum r and a dummy b value less than six digits long. The block length will be 
taken from the VTOC entry for INPUT1. 





For variable-length (FV) records on IRAM or MIRAM files, this parameter specifies a 
minimum r and the buffer length (b must be a multiple of sector size). If the specified 
b is less than the minimum allowed for the record size, as specified in the VTOC entry 
for INPUT1, then the minimum is used. 


All subparameters to this parameter have a maximum size limit of 5 decimal digits. 
OUTPUT1/INPUT2 Block and Record Length 


For fixed-length (FF) records on 8414 card tape and SAM disk files, this parameter 
specifies record length (r) and block length (b). For these files, b should be an even 
multiple of r. 


For fixed-length (FF) records on DAM disk files, this parameter specifies r, which 
excludes key length, and b, which is data length plus key length. 


For fixed-length (FF) records on ISAM disk files, this parameter specifies r, which 
includes key length, and b, which includes ISAM block overhead of two bytes per block 
plus five bytes per record. 


For fixed-length (FF) records on IRAM/MIRAM disk files, this parameter specifies r, 
which includes key lengths but excludes MIRAM record control byte, and buffer length 
(b), which must be a multiple of sector size (sector size is normally 256 bytes). 


If omitted for fixed-length (FF) records, r defaults to the INPUT1 file record length (from 
the A=( ) parameter for nondisk input or the file format labels for a disk input file). 
Block/buffer length (b) defaults to the INPUT1 file block/buffer length (from the A=( } 
parameter for nondisk and IRAM/MIRAM input files or the file format labels for all 
other disk input files). 
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Table 3—1. Keyword Parameters for Utility Input and Output Statements (Part 2 of 11) 


Keyword Parameters 


B=(r,b) 


B=(r,p) 


C=(nnnnnnn) 


For variable-length (FV) records on tape and SAM disk files, this parameter specifies 
minimum record length (r), which includes a 4-byte variable record descriptor word, 
and block length (b), which must be at least the maximum record plus four bytes for 
the variable block descriptor word. 


For variable-length (FV) records on DAM disk files, this parameter specifies minimum 
r, which includes the 4-byte variable record descriptor word but excludes key length 
and b, which is maximum record length plus key length plus four bytes for the variable 
block descriptor word. 


For variable-length (FV) records on ISAM disk files, this parameter specifies minimum 
r, which includes key length plus two bytes for the ISAM variable record discriptor 
word and b, which is at least maximum record size plus seven bytes for ISAM block 
overhead. 


For variable-length (FV) records on MIRAM disk files, this parameter specifies 
minimum r, which includes ali keys plus the 4-byte variable record descriptor word, 
and b, which must be a multiple of sector size (sector size is normally 256 bytes). 


lf omitted for variable-length (FV) records, the minimum r defaults to zero and the 
block/buffer length b defaults to the INPUT1 file block/buffer length. 


If comparing (K2) files and the INPUT2 file is a disk file, the record length for fixed 
record (FF) files and the block length for fixed (FF) and variable (FV) record files will be 
obtained from the disk file format labels and override the information in this 
parameter. For RAM and MIRAM files, buffer size may be specified here. If it isn’t, the 
minimum allowed is used. This is a performance consideration. 


For fixed-length (FF) records on the primary printer file (UiP), this parameter specifies 
the record length (r), and the print line size (p). If this parameter is omitted in this 
case, r will default to the INPUT1 record length, and a 120-character print line size (p) 
will be assumed. If r is greater than the record length of the INPUT1 file, the OUTPUT1 
record will be padded on the right with blanks. If the specified r is less than the record 
length of the INPUT1 file, the INPUT1 record length will be used. If first character 
forms control (SA) is specified, print line size (p) must include one byte for the control 
character. 


For variable-length (FV) records on the primary printer file (UiP), this parameter 
specifies a minimum and a print line size (p). The minimum r cannot be less than 2. If 
this parameter is omitted in this case, the minimum r will default to the value used for 
the INPUT1 file, and a 120-character print line size will be assumed. 


Compare Error Check 


This parameter can not be specified if copy (K1) is specified. It indicates the number (a 
decimal vaiue represented by nnnnnnn) of unequal records accepted and printed prior 
to termination, which occurs when nnnnnnn+1 unequal records are found. If omitted, 
all unequal records are printed, and the job terminates on the first end-of-file. 


Dual Output File 


This parameter requests the creation of a dual card OUTPUT2 file. The first 80 bytes of 
each OUTPUT1 record are punched. If the record length of the OUTPUT1 file is less 
than 80, the OUTPUT2 record will be blank filled on the right. The device assigned to 
the OUTPUT2 file can be an 80-column card punch, a 96-column card punch, or an 
8413 diskette. The OUTPUT2 records will be 80 bytes long regardless of the I/O 
device assigned to this file. This parameter can not be specified if file compare (K2) is 
specified, or if variable-length record (FV) is specified, or if the OUTPUT1 file is a card 
file (UIC). 
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Table 3—1. Keyword Parameters for Utility Input and Output Statements (Part 3 of 11) 


This parameter requests the creation of a dual printer output file. Each record sent to 
the OUTPUT file is printed in its entirety. The print line size is fixed at 120 for this 
file. This parameter cannot be specified if file compare (K2), correction (COR), or 
primary printer file (UIP) is specified. 






DTE=(ddd) Print Date on Output Listing 








This parameter prints the date on all output listings. The ddd specifies YMD in any 
order, where Y is the year, M is the month, and D is the day. 








Record Format 


Specifies fixed-length records 






Specifies variable-length records. This parameter cannot be specified if any of the files 
assigned to the job are 8413 card files or card files. 











Specifies variable-length records, with unblocked records in the OUTPUT1 file, for 
SAM disk and tape files only. If this is not specified and variable-length records (FV) 
are specified, then all files except DAM disk files will be variable !ength blocked. 










Specifies variable-length records for MIRAM files where: 





FV=(nnnnn) 








n 
Specifies the output file slot size for the M!IRAM OUTPUT1 file. 







The FF AND FV parameters are mutually exclusive. If both of these parameters are 
omitted and the INPUT1 file is a disk file (UDo), then the record format of the INPUT1 
file is used. If both of these parameters are omitted, and the INPUT1 file is not a disk 
file, then fixed length (FF) is assumed. 












NOTE: 
Files having fixed-length records cannot be copied to files having variable-length 
records and vice versa. 








ISAM Percent Cylinder Overflow 






This parameter specifies the percentage of a cylinder (nn) reserved for cylinder 
overflow for ISAM output files. The maximum percentage of a cylinder that can be 
reserved for overflow is 80 percent. If this parameter is omitted, 10 percent is 
assumed. 









If zero percent cylinder overflow is used to create the file, then the file can never be 
updated ({i.e., new records can never be inserted in the file). 








Halt on Record Count 





Specifies the number of records to be processed before terminating. nnnnnnn 
represents a global count of all records in the file. If R=( ) is specified, the number of 
records to be skipped before processing is inctuded in nnnnnnn for this parameter. 
The job terminates at first end-of-file. 







EBCDIC/Cotumn Binary 





Specifies that the card INPUT1 file is in EBCDIC 
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Table 3—1. Keyword Parameters for Utility Input and Output Statements (Part 4 of 11) 


12 Indicates the card INPUT1 file is in column binary code. If this parameter is specified, 
then the INPUT1 record length, as specified in the first entry of the A=( ) parameter, 
should be twice as long as the number of characters in the INPUT1 record (column 
binary code requires two bytes to represent each character). 


If both of these parameters are omitted, EBCDIC (11) is assumed. If these parameters 
are specified, the INPUT1 file must be assigned to a card reader (the INPUT1 file 
cannot be an 8413 diskette file). 





Tape Input Rewind 
ll Rewind before and rewind interlock after processing 


IK No rewind before and rewind after processing 


; 
" 


lf none of these parameters are specified, the {NPUT1 file is not rewound before or 
after processing and IM is assumed 


Copy and Compare 


K1 This parameter requests a file copy operation. The INPUT1 file is copied to the 
OUTPUT1 file. 


K2 This parameter requests a file compare operation. The INPUT1 file is compared to the 
INPUT2 file, and unequal records are printed. If this parameter is specified, a printer 
must be assigned to the job, but none of the printer file parameters can be specified. 
This parameter can not be specified if correction (COR) or if dual output (DP or DC) are 
specified. 


If both of these parameters are omitted, file copy (K1) is assumed. 


Tape Label 






















Indicates standard labeled INPUT1 and standard labeled OUTPUT1/INPUT2 


Indicates unlabeled INPUT1 and standard labeled OUTPUT1/INPUT2 
Indicates unlabeled INPUT1 and unlabeled OUTPUT1/INPUT2 


If all of these parameters are omitted, unlabeled INPUT1 and _ unlabeled 
OUTPUT1/INPUT2 (LF) are assumed. 
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Keyword Parameters for Utility Input and Output Statements (Part 5 of 11) 


MKR=(n) 


MKR=(n,m) 


MKn=(len{,loc][, DUP][,CHG]) 







MIRAM Input Key 





Specifies the key of reference to be used for this access of the MIRAM INPUT1 file, 
where n is a 1-digit decimal value between O and 5. 









Specifies the key of reference to be used for this access of the MIRAM INPUT1 file (n) 
and the key of reference to be used for this access of the MIRAM INPUT2 file (m). 
Both n and m are 1-digit decimal values between O and 5. 











If 0 is specified in either of these parameters, the MIRAM file can be either indexed or 
consecutive, but consecutive reads wil! be performed. 






If a nonzero value is specified in either of the above parameters, the MIRAM file must 
be indexed, and a read by key will be performed by using key (n) for INPUT1 and key 
(m) for INPUT2 as specified during the creation of INPUT1 and INPUT2, respectively. 





If these parameters are omitted, a read by relative record number will be performed. 


MIRAM Output Key 


Specifies one of up to five MIRAM output keys for an indexed or mixed MIRAM 
OUTPUT1 file, where: 


Is a 1-digit number between 1 and 5 that specifies the MIRAM key 
number. 


Is a 2-digit number less than or equal to 80 that specifies the length of 
this MIRAM key. 


Is a 5-digit number less than 32767 that specifies the key location, 
relative to zero, of this MIRAM key. This is the number of bytes that 
precedes the key. If this is omitted, zero will be assumed. 


Specifies that this key can have duplicates. If this is omitted, then no 
duplicates are allowed. 


Specifies this key can be changed. If this is omitted, no changes to this 
key are allowed. 


The keys specified by this parameter are the only keys associated with this file. Any 
subsequent access by key must reference one of the keys defined by this parameter. 


If MIRAM disk input and output are specified (UDD, the OM parameter with valid 
specifications, and INPUT1 is a MIRAM file), and the parameter is omitted, the MIRAM 
OUTPUT1 file will be created with the same keys as specified in the VTOC entry for 
the MIRAM INPUT1 file. 


If ISAM or IRAM disk input is specified (UDD, ISAM, or IRAM INPUT1), MIRAM disk 
output is specified (OM parameter with valid specifications), and the parameter is 
omitted. The MIRAM OUTPUT1 file is created with a single key equal to the ISAM or 
IRAM key as specified in the INPUT1 VTOC entry. 


tf MIRAM disk output is specified (UiD and the OM parameter with valid 
specifications), and the INPUT1 file is not ISAM, !IRAM, or MIRAM, the MIRAM 
OUTPUT1 file is created with a single key 10 bytes long starting in the first byte of the 
record. 
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& Table 3—1. Keyword Parameters for Utility Input and Output Statements (Part 6 of 11) 


pedal aeiaisiali 


Printer mismatch 


Do not ignore printer mismatches. 


Ignore printer mismatches. 
If both of these parameters are omitted, MN is assumed. 


These parameters cannot be specified if compare (K2) or correction (COR) is specified. 
Output EBCDIC/Column Binary 

Indicates the OUTPUT1/INPUT2 card file is in EBCDIC 

Indicates the OUTPUT1/INPUT2 card file is in column binary code. If this parameter is 
specified, the OUTPUT1/INPUT2 record length, as specified in the first entry of the 
B=( ) parameter, should be twice as long as the number of characters in the 
OUTPUT1/INPUT2 record (i.e., column binary code requires two bytes to represent 
each character). 

If both of these parameters are omitted, then EBCDIC (01) is assumed. If these 


parameters are specified, the OUTPUT1/INPUT2 file must be a card file (the 
OUTPUT1/INPUT2 file can not be an 8413 diskette file). 


®@ Tape Output Rewind 
Rewind before and rewind interlock after processing 


No rewind before and rewind after processing 

No rewind before and rewind with interlock after processing 
No rewind before and no rewind after processing 

Rewind before and no rewind after processing 


Rewind before and rewind after processing 


If none of the parameters are specified, the OUTPUT1/INPUT2 tape is not rewound 
before or after processing and OM is assumed. 


Output Disk File Type 


Indicates an ISAM OUTPUT1/INPUT2 disk file. If copy (K1) is specified, then the file is 
created without write verify active. 


Indicates an ISAM OUTPUT1/INPUT2 disk file. If copy (K1) is specified, then the file is 
created with write verify active. 


Indicates a SAM OUTPUT1/INPUT2 disk file. If file copy (K1) is specified, the OUTPUT1 
is created without write verify. 


Indicates a SAM OUTPUT1/INPUT2 disk file. If file copy (K1) is specified, the OUTPUT1 
is created with write verify. 
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Table 3—1. Keyword Parameters for Utility Input and Output Statements (Part 7 of 11) 


OR=(C[,V)) Indicates an IRAM OUTPUT1/INPUT2 disk file is to be created without write verify 
active. When this parameter is specified, the first subparameter must also be 
specified; all other subparameters are optional. These may or may not have commas 
present to indicate omitted parameters. 












The subparameters for OR=( ) are as follows: 





Cc 
Indicates a consecutive IRAM file and the file has no INDEX partition. If C 
is specified, the “p” and “’S’’ entries must not be specified in the OR=( ) 
parameter. 










Indicates the output file is to be created with an index partition. 





Specifies the index block size for this file. It is a 1-digit decimal number 
from 1 through 7 representing the number of 256-byte multiples in the 
index block. The index block size used here stands for the life of the file. 
The default value is 1. 








Indicates a sequence check on key values is performed during the 
creation of this file. If not specified, no sequence check will be performed. 











Provides IRAM/MIRAM file generation as either single or multivolume 
mount. If specified, the volume mount indicator is set so that data 
management requires all volumes of the file to be online at the same 
time. Although a multivolume mount file is the only type that can be 
processed randomly, the initial file allocation can never be extended. On 
the other hand, a single-volume mount file cannot be processed 
randomly, but can be extended. This also applies to a file occupying only 
one volume. If this parameter is omitted and input is disk, the default is 
the input file single/multivolume mount indicator. If input is card, tape, or 
diskette, single-volume mount output is assumed. 















Indicates a DAM OUTPUT1/INPUT2 disk file is to be created. !f copy (K1) is specified, 
the OUTPUT1 file will be created without write verify. 








Indicates a DAM OUTPUT1/INPUT2 disk file is to be created. If copy (K1) is specified, 
OUTPUT1 file will be created with write verify. 








OM=(C[,VILR}) 
or 
OM=(ILNLVILR) 


Specifies MIRAM disk OUTPUT1 with no write verify, where: 









Cc 





Indicates a consecutive file. 








Indicates an indexed file. 


Is a 1-digit decimal number from 1 through 7 specifying the number of 
256-byte sectors the index buffer must accommodate. The default value 
is 1. 
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& Table 3—1. Keyword Parameters for Utility Input and Output Statements (Part 8 of 11} 





Indicates multivolume mount indicator is to be set (if this file is ever 
presented to job control as a multivolume file, then all volumes of the file 
must be online at the same time). If omitted, the file will be created with 
the mount indicator set to single-mount (if this file is ever presented to 
job control as a multivolume file, then each volume of the file must be 
mounted one-at-a-time in sequence on the same disk drive). 


Indicates each record in the file is not to contain a record contro! byte. 


OMY=(C[,V].R]) Specifies MIRAM disk OUTPUT1 with write verify, where C, |, n, V, and R have the 
or same meaning as they do for the OM=( ) parameter. 


OMY=>(ILn]VILR)) ; ; ; 
or If all of these parameters are omitted, a default will be assigned as follows: 


OMY=(LnILVILR}) ; : ot ; Ses 
For a file compare (K2), where disk output was specified (UiD), the disk file type 
as specified in the VTOC entry for the INPUT2 file is used. 


For a file copy (K1), where disk input and disk output were specified (UDD), and 
none of the preceding parameters were specified, the OUTPUT1 disk file type 
will default to the INPUT1 disk file type. 


For a file copy (K1), where either card or tape input and disk output were 
specified (UCD or UTD), and none of the preceding parameters were specified, 
& the OUTPUT1 disk file type wil! default to SAM. 





ORY=(C[,V)) Indicates an IRAM OUTPUT1/INPUT2 disk file is to be created. If copy (K1) is specified, 
or the OUTPUT1 file will be created with write verify active. 


ORY=(I PILSILV1) C, |, p, S, and V have the same function as they have in the OR=( ) parameter. 


Printer Mode 


Specifies output is printed in both EBCDIC and hexadecimal code 


This parameter is used only in mixed and consolidated data management. 


If the ORA parameter is omitted, BS is assumed; however, for fixed-length records, if 
sector size is 128 and record size is equal to or less than 128, the default is UU. 
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Table 3—1. Keyword Parameters for Utility Input and Output Statements (Part 9 of 11) 


andi roe 


Printer Numbering 

PN Specifies page number and date are not to be printed 

PY Specifies page number and date are to be printed on the first line of each page. This 
parameter cannot be specified if first character forms control (SA) is specified. 


Sequence Numbering 

















Q=(c,s,n,i) Indicates the following sequence numbering is to be done: 








c 
Is the column relative to column 1, where the sequence field begins. If 
omitted, 1 is assumed. 










Is the size of the sequence field. If omitted, 6 is assumed. 


Is the sequence number of the first record to be written (up to 10 decimal 
digits with or without leading zeros). If omitted, 100 is assumed. 











Is the sequencing increment. If omitted, 100 is assumed. 


if the entire parameter is omitted, sequence numbering is not performed. 


File Repositioning 





R=(nnnnnnn) Indicates processing is to begin with logical record number nnonnnn 






R=(nnnnnnnn,nnnnnnn) For compare (K2) only. Specifies where processing begins in INPUT1 and INPUT2, 


respectively 










The number of records skipped, as specified in this parameter, is included in the 
record count for the H=( ) parameter, if it is specified. 


If R=( ) is omitted, processing begins with the first logical input record. 


Printer Spacing 






Single space after printing 


Double space after printing 
Triple space after printing 


The first character of each input record is used for forms control. This option is not 
allowed if the page numbering (PY) parameter is specified. If this parameter is 
specified, the device independent control characters must be used. See the basic data 
management user guide, UP-8068 (current version) for details. 












If the SA parameter is specified, then TL and OC are assumed for print format and 
mode. 






The SA parameter is not allowed if a file compare (K2) is specified. 


These parameters cannot be specified if correction (COR) or compare (K2) is specified. 
If these parameters are omitted, single spacing (S1) is assumed. 
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Table 3—1. Keyword Parameters for Utility Input and Output Statements (Part 10 of 11) 


Printer Format 


Print in display format 


Print in list format 


lf TD and TL are omitted, list format (TL) is assumed. These parameters cannot be 
specified if correction (COR) or compare (K2) is specified. 


Key Length 


V=(nnnnn) For a file copy (K1), this specifies the key length (less than 6 decimal digits) for the 
OUTPUT1 (UiD) disk file. If this parameter is omitted and the INPUT1 file is a disk file 
(UDD and K1 are specified), the INPUT1 key length specified in the INPUT1 VTOC entry 
is used. Otherwise, a 10-byte key is assumed. If file compare (K2) is specified, the key 
length is taken from the VTOC entry for the INPUT2 file. 


Since the key lengths for all input disk files are taken from the VTOC entries for the 
corresponding files, no input disk key length parameter is provided. Data management 
supports keys only for disk files. 


V=(mmmmm,nnnnn) This form of the parameter also is accepted. It has the same function as the 
V=(nnnnn) parameter except that mmmmm is a dummy entry (less than 6 decimal 
digits) that is always ignored. The second entry, nnnnn, has the same function and 
defaults as in the V=(nnnnn) parameter. 


Variable Sector Size 


Specifies that the data partition for an IRAM or MIRAM output file is to be written by 
using a sector size other than 256 bytes (illegal for 8416/8418 disk drives). Also, it 
specifies that the DATA routine is to compute the sector size as being equal to the 
highest even multiple of the slot size that fits into the buffer size as specified by the 
second entry in the B=( ) parameter. See the basic data management user guide, UP- 
8068 (current version) for an explanation of slot size. 


VS=(nnnnn) Specifies that DATA routine is to use value entered for nnnnn as sector size 


If both of these parameters are omitted, the sector size is 256 bytes. 
Key Location (ODAM/ISAM/IRAM Files) 


W=(nnnnn) For a copy operation (K1), this specifies the key location (the number of bytes that 
precede the key) for the OUTPUT1 file (UiD). If this parameter is omitted and the 
INPUT1 file is a disk file (UDD and K1 are specified), the INPUT1 key location as 
specified in the INPUT1 VTOC entry is used. Otherwise, a key location of O is used for 
fixed-length (FF) files, a key location of 2 is used for ISAM variable (Ol and FV 
specified) files, and a key location of 4 is used for all other variable-length disk files. 


For file compare (K2), the key location is taken from the VTOC entry for the INPUT2 
file. 


W=>(mmmmm,nnnnn) This form of the parameter also is accepted to indicate the key location. It has the 
same function as the W=(nnnnn) parameter, where mmmmm is a dummy entry that is 
always ignored. The second entry, nnnnn, has the same function and defaults as in 
the W=(nnnnn) parameter. 


Write Protect of Output Diskette on Close 


WPC=(N) Specifies that the write protect option is to remain as specified 
wPec=(Y) Specifies that the diskette be marked as write protected 


If omitted, N is assumed. This parameter is used only in mixed and consolidated data 
management environments. 
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Table 3—1. Keyword Parameters for Utility Input and Output Statements (Part 11 of 11) 


Write Protect of Output Diskette on Open 










WPO=(E) Erase the write protect. 


Leave the write protect as specified. 

If you don’t erase the write protect mark at open, the DATA routine cannot write to 
the file. 

if omitted, N is assumed. This parameter is used only in mixed and consolidated data 
management environments. 


Sequence Checking 






WPO=(N) 






X=(r,$) Specifies sequence checking, where r specifies the first column of the sequence field 
(relative to column 1), and s is the size of the sequence field (maximum value is 40). 


If no column number is specified, 1 is assumed; if no size is specified, 6 is assumed. 


The record is checked for a sequence w field that is higher than the corresponding 
field in the preceding record. When a sequence error occurs, an error message is 
logged, processing continues, and the new lower number is used as the new base for 
subsequent checking. If this parameter is omitted, sequence checking is not 
performed. 







ASCII Tape 





Indicates the INPUT1 tape file (UTo), will be in ASCII format. For fixed length records 
(FF), a buffer offset length of O is used. For variable length records (FV), a buffer offset 
length of 4 is used. A data management length check is performed using the contents 
of the buffer offset, which must contain the block length in decimal. 








Only variable-length ASCII output tapes are supported by data management, so only 
variable format is available for data utilities to create. 


Identical to YI except that no length check is made for variable records 


Identical to YI except that (i) is treated as a decimal value representing buffer offset 
length. For fixed format records, the buffer offset is ignored. For variable format 
records, the first four bytes are assumed to be the record length in decimal, and the 
rest of the buffer offset is ignored. 


identical to YI=(i), except that no length check is made for variable records 
lf any of the preceding parameters are omitted, EBCDIC input is assumed. 











YB 







Combines functions of parameters Yl (ASCII input) and YO 
Combines functions of parameters YIN and YO 


Combines functions of parameters YI=(i) and YO 






YBN 







YB=(i) 








YBN=(i) Combines functions of parameters YIN=(i) and YO 


Specifies ASCH output for variable-length record format; 4-byte buffer offset record 
length is written in decimal. 


If all of the previous parameters are omitted, EBCDIC output is assumed. 






Yo 


Tape mark 


ZN Do not write tape mark on unlabeled output tape. 


ZY Write leading tape mark on unlabeled output tape. 


If both of these parameters are omitted, ZN is assumed. 
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3.3. MODIFIER STATEMENTS 


You can modify DATA routine utility input and output (Uio) statements by using utility 
modifier statements: 


a FS statement (field select) 

Move selected fields within a record. 
=» SEL/DEL statement (select/delete) 

Select or delete records. 
# Hn statement (title) 

Print page headings. 
. COR statement (correction) 

Insert, delete, or replace records. 
. PAR statement (partition) 

Specify information required for processing nonindexed multiple-partitioned files. 
If you use any of these optional statements, they must appear in your job control stream 
following the Uio statement. If no utility modifier statements are used, the records are 
copied or compared without change. 
The modifier statements FS, SEL/DEL, COR, and PAR have the same general format as 
the Uio statement (3.2). The statements are written starting in column 1 and ending in or 
before column 71. The keyword parameter portion (ppp) defines the operation and the 
files. Coding follows the same rules as for the Uio statement. The title (Hn) statement uses 
the format described in 3.3.3. The five modifier statements are described in 3.3.1 through 
3:3.5; 
3.3.1. Field Select Statement - Moving or Deleting Input Record Fields 
The field select (FS) statement specifies the fields in the input records that are to be 
rearranged, omitted, or converted when copied from the input data record to an output 
record. The input fields must be within fixed-length records or within the fixed portion of a 
variable-length record. 
Fields may be moved to the same or different portions of the output record or deleted 
entirely from the output record. Fields in the output record not selected to receive data are 
blank filled (X‘40’). A maximum of 50 formatting options may be specified to move a record . 


within the limits of available space required to store the information in main storage. If the 
output is to the printer, the list format must be used. (See Figure 2-6.) 
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The selected fields may be: 


moved without change; 
converted from zoned to packed decimal and then moved; 
converted from packed to zoned decimal and then moved; 


converted to hexadecimal for printer output and then moved; 


converted but remaining in the same location on the output record; or 


deleted. 
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Disk input key fields may be selected and transferred to output key fields or to data fields. 
However, the selected field must be contained entirely within either the disk key field or 
the data field. 


When converting a field from zoned to packed decimal, or packed to zoned decimal, the 
output field will be smaller or larger than the input field, depending on the conversion you 
specify. The resulting field-selected record may not exceed the output record size, the 
output block size, or the printer line size as defined in your Uio statement. The rules that 
apply to the output field size are: 


Zoned to packed decimal conversion 


When the input field contains an even number of bytes, as in: 


Byte 1 Byte 6 


a me" 


The resulting output field is: 
Byte 1 Byte 4 
lett =~, 


To compute the size of the output field, apply the formula: 


x=(n+2)+1 





where nr is the size of the input field and x is the size of the output field. 
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When the input field contains an odd number of bytes, as in: 


Byte 1 Byte 5 


Foetinea eatin 


The resulting output field is: 


Byte 1 Byte 3 
on mem V etienaa 


po | a [ose 


To compute the size of the output field, apply the formula: 
x=(n+1)+2 
where n is the size of the input field and x is the size of the output field. 
= Packed to zoned decimal conversion 
When the input field contains an even number of bytes, as in: 


Byte 1 Byte 4 


omen met amnesia 


The resulting output field is: 


Byte 1 Byte 7 
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When the input field contains an odd number of bytes, as in: 


Byte 1 Byte 5 


oe _ 
jar fies fe | [rom 


The resulting output field is: 


Byte 1 Byte 9 


—_———, eet 


Whether the input field contains an even or odd number of bytes, the size of the 
output field is computed by the formula: 





x=2n-1 
where n is the size of the input field and x is the size of the output field. 
® Convert from EBCDIC character mode to hexadecimal 
The size of the output field is twice the size of the input field. 
Example: 
EBCDIC input field: 
01234 
Hexadecimal output field: 
FOF 1F2F3F4 
In the field select statement, all numbers are expressed in decimal! and the specified 
Starting position of the selected field is relative to the first character of the record (position 
1). Commas separate definitions within each selected field; slashes separate the selected 
fields. Selected fields must be contained entirely on one card. Also, parentheses must be 


coded as shown. 


There are two basic formats for the field select statement: one for fixed-length records and 
one for variable-length records. 
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& 3.3.1.1. FS Statement Format for Fixed-Length Records 


OPERATIONA | OPERAND 





FS a,b,c[,d]/a,b,c[{,d]/.../a,b,c[,d] 


Each group of subparameters in the operand defines the field of a fixed-length input 
record and is specified in its output order. The subparameters are positional within each 
group. 


a 
Specifies the starting position of the fixed-length input record field. The two 
options for this subparameter are: 


tins 


where: 


Is a decimal number specifying the starting position of the input 
© record field, or the starting position of the key field. 


Indicates that the input record field referenced is within the key 
field of a record in a DAM file. 


Specifies the length of the field being copied or compared. The four options for 
this subparameter are: 


s 
(P,n,m) 
(U,n,m) 
(X,n) 


where: 


Is a decimal number specifying the size of both the input and 
output field in bytes; this implies that no conversion is to take 
place. 


Indicates that the contents of the input field are to be converted 
from zoned decimal to packed decimal before being transferred to 
@ . the output file. The input field must be in EBCDIC. 
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Indicates that the contents of the input field are to be converted 
from packed decimal to zoned decimal (unpacked) before being 
transferred to the output file. The input field must be packed 
decimal. 


Indicates that the contents of the input field are to be converted to 
hexadecimal before being transferred to the printer output file. The 
size of the output field must be twice the size of the input field. 
The input field must be packed decimal. 


Is a decimal number specifying the byte size of the input field. 





Is a decimal number specifying the byte size of the output field. 


Specifies the starting position of the fixed-length output record field. The two 
options for this subparameter are: 


t 
(K,t) 


where: 





Is a decimal number specifying the starting field position of the 
output record or the starting position of the key field. 


Indicates that the output record referenced is within the key field 
of a record in a DAM file. 


Is an optional parameter specifying that unpacked output fields are to reflect 
their sign. The four options are: 


P 
Print a plus (+) if the output field is positive. 


Print a minus (-) if the output field is negative. 


Print a plus (+) or minus (-) depending on whether the field is positive 
or negative. 





Print no sign. 


If omitted, N is assumed. 


UP-8069 Rev. 9 SPERRY UNIVAC OS/3 3-53 
DATA UTILITIES 


3.3.1.2. FS Statement Format for Variable-Length Records 
For variable-length records, the following rules for field selection apply: 


# Only that portion of the input record that is fixed in size and is always present may be 
selected. 


= The record length field is generated in the first four bytes of each output record. 
Selected fields may not be transferred into these four bytes. 


= When the variable portion of a variable-length record is to be copied to output, the 
letters CV (copy variable) must be specified within the FS statement. The variable 
portion of the record is placed in the output record following the fixed portion of the 
record. 


A maximum of 50 formatting options may be included. The definitions for the a, b, c, and d 
subparameters are given in 3.3.1.1. The various positions for the CV specification field are 


as follows: 
OPERATIONA | OPERAND 


FS CV/a,b,c[,d]/a,b,c[,d]/a,b,c[,d] 


This format is used when the variable portion of the input record is to be moved to the 
output record before the selected fields are moved. 


OPERATIONA | OPERAND 


FS a,b,c[{,d]/a,b,c[,dJ/a,b,c[,d]/CV 


This format is used when the variable portion of the input record is to be moved to the 
output record after selected fields have been moved. 


OPERATIONA OPERAND 


FS a,b,c[,d]/CV/a,b,c[,d]/a,b,c[,d] 


This format is used when the variable portion of the input record is to be moved to the 
output record between the moves of the selected fields. 


3.3.1.3. FS Statement Examples 


The following examples illustrate the use of the FS statement for both fixed-length and 
variable-length records. 


Example 1 - Pack fixed-length records: 
Assume that an input field record contains eight fields. The fields numbered 1, 2, 7, 


and 4 are to be moved, in that order, to the output area; fields numbered 2 and 7 are 
to be packed while being moved. The fields are: 
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Field Name 


Name 

Hourly rate 

Number of dependents 
Earnings to date 
Address 

Date of service 

Hours worked 

Weekly earnings 


The FS statement is: 


1 10 


FS 1,15,1/16,(P,5,3),16/72,(P,3,2),19/23,8,21 


20 30 40 


The resulting output record is: 


Number 


PWN — 


Field Name 


Name 

Hourly rate 
Hours worked 
Earnings to date 


Positions 


1-15 

16-20 
21-22 
23-30 
31-66 
67-71 
72-74 
75-80 


50 


Positions 


1-15 

16-18 
19-20 
21-28 


Example 2 - Unpack and convert fixed-length records to hexadecimal: 


Assume that an input file record contains five fields. Fields numbered 1, 3, 4, and 5 
are to be moved to output. Field 1 is to be unpacked. Field 3 is to be converted to 
hexadecimal. Fields 4 and 5 are to be moved without change. The input fields are: 


Number 


ahWN— 


Field Name 


Life number, packed format 
Number of dependents 
Name 

Hours worked 

Weekly earnings 


The FS statement is: 


1 10 


20 30 40 


FS 1,(U,5,9),1/21,(X,28),21/62,4,62/66,5,66 


The resulting output record is: 


Number 


hON = 


Field Name 


Life number, unpacked format 
Name, in hexadecimal 

Hours worked 

Weekly earnings 


Positions 


1-5 

15-20 
21-40 
62-65 
66-70 


50 


Positions 


1-9 

21-60 
62-65 
66-70 
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@ Example 3 — Reorder and move key fields of fixed-length records on disk: 


Assume that an input file contains nine data fields and a disk key field. The first field 
is the key field; its contents are to be transferred to the output key field. Fields 2, 5, 6, 
7, and 8 are to be dropped. Fields 3, 4, 9, and 10 in that order are to be transferred to 
the output record. Fields 4 and 9 are to be packed while being moved. The input fields 


are: 


Number 


—-OANDOAARWN — 


0 


Field Name 


Social security number 
Department number 
Name 

Hourly rate 

Number of dependents 
Earnings to date 
Address 

Date of service 

Hours worked 

Weekly earnings 


The FS statement is: 


1 10 


FS (K,1),18,(K,1)/6,15,1/21,(P,5,3),16/77,(P, 


20 30 


The resulting output record is: 


Number 


ahwn- 


Field Name 


Social security number 
Name 

Hourly rate 

Hours worked 

Weekly earnings 


Positions 


1-10 (Key field) 
1-5 

6-20 

21-25 

26-27 

28-35 

36-71 

72-76 

77-79 

80-85 


50 60 
3,2),19/88,6,21 


Positions 


1-10 (Key field) 
1-15 

16-18 

19-20 

21-26 


Example 4 - Interchange fixed portion and copy variable portion of variable-length records: 


Assume that an input file contains variable-length records. The minimum length of a 
logical record is 24 bytes, and the maximum block length is 300 bytes. The fixed 
portion of the logical record is defined as 24 bytes consisting of two 10-byte fields 
and the 4-byte record-length field. The two 10-byte fields are to be interchanged, and 
the variable portion of each logical record is to be copied. The input fields are: 


Number 


1 
2 


Field Name 


Field A 
Field B 
Variable portion 


Positions 


5-14 
15-24 
25-275 (maximum) 


’ UP-8069 Rev. 9 


The FS statement is: 


1 10 20 30 


FS 5,16,15/15,18,5/CV 


The resulting output record is: 


Number Field Name 
1 Field B 
2 Field A 


Variable portion 
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Positions 


5-14 
15-24 
25-275 (maximum) 


Example 5 — Move fixed portion of variable-length records: 


Assume that an input file contains variable-length records. The minimum length of a 
logical record is 34 bytes, and the maximum block length is 300 bytes. The fixed 
portion of the logical record is defined as four bytes and three 10-byte fields. The first 
and third 10-byte fields are to be moved to positions 5 through 24 in the fixed portion 
of the output record, and the second 10-byte field is to be moved to positions 35 


through 44. 
Number Field Name 
1 Record length 
2 Name 
3 Address 
4 Life number 
5 Variable portion 


The FS statement is: 


1 10 20 30 
FS 5,18,5/25,18,15/C0V/15,18,35 


The resulting output record is: 
Number Field Name 


Record length 
Name 

Life number 
Blanks 

Address 
Variable portion 


Onahanr=— 


Positions 


1-4 

5-14 

15-24 

25-34 

35-300 (maximum) 


Positions 


1-4 

5-14 

15-24 

25-34 

35-44 

45-310 (maximum) 
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3.3.2. Select or Delete Statement - Selecting or Deleting Records 


The select statements (SEL, SELAND, and SELOR) and the delete statements (DEL, 
DELAND, and DELOR) are used in conjunction with the Uio statement to select or delete 
records, respectively, during a copy operation. The selection or deletion of records is based 
on matching a portion of each record with a search argument. The matching portion is 
defined as the search key field and is specified in either the data or key portion of the 
record. The search argument consists of a relational operator and a character string that 
represents the constant against which all search fields are matched. The relational 
operators used to qualify the search argument are equal to (=), greater than (>), or less 
than (<). 


The INPUT1 file is searched, comparing the specified search key field of each record with 
the search argument. If the search key field of an input record matches the search 
argument (depending on the relational operator), then the record is either selected or 
deleted, depending on the requested function. Either SEL or DEL may be specified, but not 
both. Only one SEL or one DEL statement can be specified. If more than one is entered 
during a job, only the last SEL or DEL statement is executed. You can specify a maximum 
of five SELAND, SELOR, DELAND, or DELOR statements, each containing a single 
argument; however, the statements must all be the same (i.e., all SELAND statements or 
all DELOR statements). 


If the FS statement is also specified, the select or delete function is performed before the 
field select function. 


The format for the select and delete statements is: 


OPERATIONA OPERAND 





SEL D=(nnnnn))y ,Af>)(sssss,aa...a) 
SELAND feet | 

SELOR < 

DEL 

DELAND 

DELOR 


SEL is the operation code used to select records when a match exists between the search 
key field and the search argument. All records not selected are ignored. 


DEL is the operation code used to delete records when a match exists between the search 
key field and the search argument. All records not deleted are used as input. 


SELAND and DELAND are the operation codes for the ‘select and’ and ‘‘delete and” 
functions, which allow from one to five search key field/search argument pairs. If a// of 
the search key fields of an input record match their corresponding search arguments, the 
record is selected (SELAND) or deleted (DELAND) for output. 


SELOR and DELOR are the operation codes for the ‘select or’’ and ‘‘delete or’’ functions, 
which allow from one to five search key field/search argument pairs. If any of the search 
key fields of an input record matches its corresponding search argument, the record is 
selected (SELOR) or deleted (DELOR) for output. 
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Keyword parameter D=(nnnnn) specifies, in decimal, the starting position of the first byte 
of the search key field relative to the first character in the record. If the record is a disk 
record with a key field, this parameter indicates the position of the search key field in the 
data portion of the record. 


Keyword parameter K=/(nnnnn) specifies, in decimal, the starting position of the field 
within the hardware key of a keyed DAM or NI file. 


Keyword parameter A is the search argument definition, where sssss is the length in bytes 
of the search argument and aa...a is the search argument. The value of the comparison for 
a match between the search key field and the constant in the search argument is 
indicated as follows: 


A>(ssss$,aa...a) 
All records whose search key field is greater than the search argument are either 
selected or deleted, depending on the function specified. 


A<(sssss,aa...a) 
All records whose search key field is less than the search argument are either 
selected or deleted, depending on the function specified. 


A<(sssss,aa...a) 
All records whose search key field is less than the search argument are either 
selected or deleted, depending on the function specified. 


Subparameter sssss specifies the length of the search argument. 
Subparameter aa...a is the character string representing the search argument. 
Example 1: 


1 10 16 
SEL D=(6),A=(3,588) 


The search field for each record starts in position 6 of the data portion of the record 
and is matched for an equal condition with the search argument containing a 3-byte 
character string of 500. The records that satisfy the match are written to the output 
device. 


Example 2: 


1 10 20 
DEL K=(1),A>(3,222) 


The search field for each record starts at position 1 of the disk key field and is 
matched for a greater-than condition with the search argument containing a 3-byte 
character string of 222. The records that satisfy the match are deleted during the 
copy function. 
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Example 3: 


Suppose you want to select all records for women older than 35. If the sex of the 
person is in column 3 and the age is in column 50 of the record, the following 
SELAND statements are used: 


1 10 20 30 


SELAND D=(3),A=(1,F) 
SELAND D=(50),A>(2,35) 


3.3.3. Title Statement - Printing Page Headings 


The title (Hn) statement is used, in conjunction with those Uio statements that specify the 
printer as the primary or secondary output device, to print page headings. You can code a 
maximum of three Hn statements (each with a maximum of 160 characters) to have page 
headings printed on the first three lines of each page. If you have included the PY | eyword 
parameter in your Uio statement, page headings begin on the first line of each pz ge. The 
title statement is not supported for compare (K2) operations. 


The Hn statement has the following format: 





1 10 20 30 40 50 60 72 
1. An———— eading ooo eee 
_ 2. A—_—_—e__ beading ——_—————oo > FX 
3. A— heading ———> 
where: 


Is 1, 2, or 3 specifying that the character string beginning in column 5 is to be 
printed as line 1, 2, or 3, respectively, of the title. 


heading 


Is the character string representing the title. This may be a maximum of 160 
characters, with 67 characters coded on line 1, 70 characters on line 2, and 23 
characters on line 3. 


Represents any nonblank character used to indicate continuation. The 
continuation character is coded in column 72. The heading is continued on the 
next line (2 or 3) beginning in column 2. The DATA routine assumes that column 
2 of line 2 is location 68 of the heading and that column 2 of line 3 is location 
137 of the heading. 


When the DATA routine scans your Hn statement, it assumes column 5 of the Hn 
statement is location 1 of the heading; therefore, a character to be printed in position n of 
a heading must be punched in column n+4 of the Hn statement. For example, if a 
particular column of information in your job is to be printed beginning in location 10, you 
must code the heading in the Hn statement beginning in column 14. 
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if you define a printer line length via the B=(r,p) keyword parameter in the UCP, UDP, or 
UTP statement, the character string must not exceed this length. 


Example: 

1 10 20 30 40 
1. | AHI GOLF TOURNAMENT 
2. AH2 PLAYER SCORES 


Printer output: 


GOLF TOURNAMENT 


PLAYER SCORES 


The printed output of line 1 shows the character string GOLF TOURNAMENT beginning in 
print position 10, PLAYER beginning in print position 5, and SCORES beginning in print 
position 24. These character strings were coded four positions to the right because the 
DATA routine considers column 5 in the Hn statement equal to print position 1 in the 
printed page. 


The headings are double spaced because the keyword parameter S2 was included in the 
Uio statement. 


3.3.4. Correction Statement - Correcting Records 


The correction (COR) statement is used to correct records in an existing file during a copy 
operation. The corrections are made by means of a series of control cards. These control 
cards are read in as data cards from the control stream. Through their use, a file can have 
records inserted, deleted, or replaced. The control cards must be in numerical order 
according to record number. The corrections appear on the OUTPUT1 file; the records in 
the INPUT1 file are unchanged. In the event of deletions or insertions, the records may be 
reblocked to suit record positions. 


The COR statement specifies the number of new correction records to be processed, 
where processing is to begin in the file, and where processing is to end, if applicable. 


When replacing or inserting records, data cards containing the new or corrected data must 
immediately follow the COR statement that describes the location in the file for these 
records. The COR statement, together with any associated data cards, must be the last 
utility modifier statement in your control stream. 


The format of the COR statement is: 


OPERATIONA OPERAND 











COR N=(x),A=(s),B=(e) 
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& Parameters: 


N=(x) 
Specifies the number of correction records (99 maximum) to be replaced or 
inserted. If the records are to be deleted, x must be zero. 


A=(s) 
Specifies the 1- to 7-digit number of the starting record within the file. When 
replacing or deleting records, s specifies the record number of the starting 
location for the correction records. When inserting corrections, s specifies the 
record number that the correction records are to follow. 


B=(e) 
Specifies the 1- to 7-digit number of the ending record within the file. The 
ending record, specified by e, is the last one to be replaced by the new records. 


The data card formats that follow the COR statements are: 


First data card: 





Subsequent cards: 


1 80 


data ... 


Columns 1 through 5 of the first data card specify the number of bytes supplied on the 
data cards for this record. For variable record format INPUT1 files, the DATA routine will 
construct a 2- or 4-byte record descriptor word as appropriate for the INPUT1 file type if 
field selection is specified or the OUTPUT1/OUTPUT2 file type if field selection is not 
specified. The maximum length is 32767. Columns 6 through 80 of the first data card 
contain positions 1 through 75 of the record to be added. If the record length is less than 
75, the rightmost columns of the card are ignored. 


If the data exceeds column 80 of the first data card, subSequent cards may be used with 
the data description beginning in column 1. As many cards as necessary can be used to 
supply the required number of characters in the record. The subsequent cards successively 
contain positions 76 through 155, 156 through 235, 235 through 315, etc., of the record. 
Portions of the record that exceed the length specified by nnnnn are ignored. 


@ Each new record must begin on a new card. 
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Example: 





1 10 20 30 





COR N=(2),A=(1),B=(2) 





OOHIT7TTOURNAMENTARECORD 
OHH2GNOATHREEAPUTTAGREENS 
COR N=(2),A=(6) 
OOHBLIAVERAGEADRIVE 
OHHBIZEBAYARDS 
COR N=(8),A=(18) , B=(12) 


SOM Sw DhY = 


The first COR statement specifies that the contents of lines 2 and 3 are to be placed 
between record 1 and record 2. The COR statement in line 4 specifies that two records are 
to be inserted after record 6. Lines 5 and 6 contain the data to be inserted. The last COR 
statement specifies that all records between record 10 and record 12 are to be deleted. 


3.3.5. Partition Statement - Handling Nonindexed Files 

The DATA routine is capable of handling nonindexed partitioned data files on direct access 
storage devices supported by OS/3 data management. The partition (PAR) statement is 
used in conjunction with the Uio statement to process files composed of multiple partitions 


as either input files or output files. A maximum of seven partitions is allowed. 


The format of the PAR statement is: 





OPERATIONA OPERAND 





PAR Pi,Po,,[Pi,P0,,Pi,Po3,..., Pi,Pog. ] 
P1l= a i ea ; 
KEYED 
P2= ROME ree marge Ope porave pee easiness , 
KEYED 
Pa= SAPS yy nN manne een ee 
KEYED 


If more than one card is used to enter the partition information, each card must begin with 
the statement identifier PAR, and the last operand on each card must be followed by at 
least one blank space (no comma). 


The PAR statement may be placed anywhere within the appropriate data utility control 
cards except after the first COR card. 


The PiPo operand specifies the partition number of the input and/or output partitions. The 
/ portion specifies the partition number of the partition in INPUT1 to be processed, and the 
o portion specifies the partition number of the partition in OUTPUT1 (or INPUT2) to be 
processed. 


If either the input or output file is SAM (created by DTFSD), the partition number for that 
file must be zero. 
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If only the input data or only the output data is from a partitioned file, or if both the input 
and output partition numbers are the same, the PiPo operand takes the form of Pn, where 
n is the number of the partitions to be processed. The value of m may be from 1 through 7. 


When copying partitions, all Uio, FS, SEL, DEL, and COR parameters apply only to the 
partition specified in the first P/Po operand encountered in the control stream. All other 
partitions (P/Po2,...,Pi,Po,) are copied without change. 


The operands 


P.,=(recsize ,,,biksize , + { record-format nt /SiZ@ ,,UOS p) 
KEYED 


specify the necessary volume table of contents (VTOC) information for the OUTPUT1 
partition specified as n. If operands of this type are not entered, the VTOC information for 
OUTPUT1 partitions will be taken from the INPUT1 VTOC information. The size 
subparameter defaults to 100/x, where x is the number of partitions being written and the 
uos subparameter defaults to zero if the input file is not a nonindexed (NI) file. 


One operand of this type must be entered for each partition of the OUTPUT1 file unless 
the input file contains the same number of partitions, and a P/Po operand is specified for 
each partition. If the /NM/T option is specified on the LFD job control statement for 
OUTPUT1, one operand of this type must be entered for each partition of the OUTPUT1 file 
whether or not a P/Po operand is entered for that partition. 


Subparameters 


recsize 
Specifies the record size for fixed-length records. For variable-length records, this 
subparameter specifies the minimum record size of the variable-length record. If 
the file has keys, this subparameter specifies the key length. 


biksize 
Specifies the block size for fixed-length blocks. For variable-length blocks, this 
subparameter specifies the maximum block size of the variable-length block. If 
the file has keys, this subparameter specifies the length of the data. 


KEYED 
Specifies the partition is keyed. All keyed partitions must be fixed length and 
unblocked. 


record-format 
Specifies the record format for nonkeyed partitions. The specification may be: 


FIXUNB fixed-length, unblocked records 
FIXBLK fixed-length, blocked records 
VARBLK variable-length, blocked records 
VARUNB variable-length, unblocked records 
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size 
Specifies the percentage of total file allocation to be initially assigned by data 
management. Used only with partitioned, nonindexed files. If omitted, the input 
specification in the VTOC is used. 





uos 
Specifies, as the unit of store, the percentage of secondary disk storage 
allocation for the file that data management is to suballocate to the partition 
being defined each time it requires more space. The value may not exceed 100. 
Secondary storage allocation is specified in the EXT job control statement in the 
device assignment set for the file. Used for the first (or only) partition of a 
nonindexed file. !f omitted, the value stored in the VTOC is used. 


Refer to the basic data management user guide, UP-8068 (current version) for a further 
explanation of the DTFNI SIZE=n and UOS=n keyword parameters. 


Example 1: 


Assume that INPUT1 is to be copied to OUTPUT1 with the following specifications: 


OUTPUT1 OUTPUT1 
Partition Partition 
size (%) uos (%) 


INPUT1 OUTPUT1 | Partition Partition Partition 
Partition | Partition recsize blksize Format 





VARBLK 
KEYED 
FIXBLK 
FIXBLK 
FIXUNB 
VARBLK 


KEYED 





*When copying partition 4 to partition 5, apply the parameters of the Uio, FS, SEL, DEL, and COR statements. 


The PAR statements are: 


1 10 20 30 40 





PAR P4P5,P1P7,P2P4,P3P1,P5P2,P6P6,P7P3 
PAR Pi=(72,726,FIXBLK, 14,58) 

PAR P2=(168,168,FtXUNB,17,1686) 

PAR P3=(9,88,KEYED,11,58) 
P4=(5,189,KEYED,18,586) 

PAR P5=(115,345,FIXBLK,15, 28) 

PAR P6=(8,120,VARBLK,15,75) 

PAR P7=(8,244,VARBLK,19,33) 





co™~!] ® on & WG Re 
~~ 
> 
= 
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If statements in lines 2 through 8 had not been entered, the required information for 
the first three subparameters would have been taken from INPUT1 VTOC. However, 
all size subparameters would have defaulted to 14, and all vos parameters would 
have defaulted to zero. Thus, the recsize, blksize, and record format of partition 3 of 
INPUT1 would have been used for partition 1 of OUTPUT1; the recsize, blksize, and 
record format of partition 5 of INPUT1 would have been used for partition 2 of 
OUTPUT1, etc. (Note the P/Po operands.) 


Example 2: 


Assume that partition 5 of INPUT1 is to be copied to partition 1 of OUTPUT1 and 
OUTPUT1 is to be a single partition file (recsize=90, blksize=180, fixed block). 


The PAR statement is: 


1 10 20 30 40 





PAR P5P1,P1=(98,189,FIXBLK,199,8) 


Note that the second operand (P7=) could have been omitted because the given 
values are default values. 


Example 3: 


Assume that partition 7 of INPUT1 is to be compared with partition 7 of INPUT2. 
The PAR statement is: 


1 10 
PAR P7P7 


Note that operand P7P7 could have been entered as P7. 


Example 4: 


Assume that partition 3 of INPUT1 is to be printed. 
The PAR statement is: 


1 10 
PAR P3 


3.4. MINIMUM MAIN STORAGE REQUIREMENTS 
Most executions of the DATA routine can be accomplished in 32K bytes of main storage. 
However, if you want to compute the exact amount of minimum main storage required to 


process the DATA routine, use the following formula: 


M = Maximum of (31,145, B) 
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Is the minimum amount of main storage required to run this job. 


Is the calculated total number of bytes of main storage required for your job. It 
represents the sum of the requirements for the functional routines, input/output 
routines, and data management buffers. B can be determined by the following 
formula: 


B =( 24,300 + FT + 1IOT+C+D+E+F+G+H+I+ J) 


where: 

M 

B 

where: 
FT 
1OT 
Cc. 
D 
E 


Is the total size of the functional routines required by this job. The sizes of the 
functional routines are specified in the functional routine size table (Table 
3-2) along with the parameters that specify the function. 


Is the size of all DTFs and I/O routine modules for all files used in the job. The 
printer DTF and 1/O routine module is included in the printer routine size 
given in Table 3-2, so printer files are not included in this value. See Table 
3-3 for the I/O routine sizes. 


Is the INPUT1 record size as specified in the first entry of the A=( ) parameter. 
If a // DD statement with a RCSZ= parameter is specified for this file, then 
this value will be used and it will override the value specified in the A=( ) 
parameter. If the INPUT1 file is a disk file, then the record size specified in the 
VTOC entry is used and it will have the final override. 


Is the INPUT1 block/buffer size as specified in the second entry of the A=( ) 
parameter. If a // DD statement with a BDSZ= parameter is specified for this 
file, then this value will be used and it will override the value specified in the 
A=( ) parameter. If the INPUT1 file is a disk file and a buffer size was specified 
in the second entry of the A=( ) parameter, then that value will be used. If the 
INPUT1 file is a disk file other than IRAM/MIRAM and the A=( ) parameter is 
not specified, then the minimum allowable buffer size will be calculated by 
using the record size specified in the VTOC entry for the INPUT1 file. 


Is the OUTPUT1/INPUT2 record size as specified in the first entry of the B=( ) 
parameter. If a // DD statement with a RCSZ= parameter is specified for this 
file, then this value will be used and it will override the value specified in the 
B=( ) parameter. If this is a compare operation, (K2 parameter) and the 
INPUT2 file is a disk file, then the record size specified in the VTOC entry is 
used and it will have the final override. 
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Is the OUTPUT1/INPUT2 block/buffer size as specified in the second entry of 
the B=( ) parameter. If a // DD statement with a BKSZ= parameter is 
specified for this file, then this value will be used and it will override the value 
specified in the B=( ) parameter. If compare is specified (K2), the INPUT2 file 
is a disk file, and the buffer size is specified in the B=( ) parameter, then that 
value will be used. If compare is specified, the INPUT2 file is a disk file, and 
the B=( ) parameter is not specified, then the minimum allowable buffer size 
is calculated by using the record size specified in the VTOC entry for the 
INPUT2 file. 


This variable is for ISAM and IRAM INPUT1 files only. It is the record key 
length specified in the VTOC entry for the INPUT1 file, and for ISAM and 
IRAM INPUT1 files only. 


Is for ISAM and IRAM OUTPUT1/INPUT2 files only. It is the record key length, 
as specified in the V=( ) parameter. If this is a compare (K2), then the key 
length is taken from the disk file format labels. 


Is for IRAM and MIRAM INPUT1 disk files only. It is the index buffer size and 
is taken from the disk file format labels. 


Is for RAM and MIRAM OUTPUT1/INPUT2 files only. It represents the disk 
file index buffer size and it is calculated by multiplying the second entry in the 
OR=(I,n) or the OM=(I,n) parameter by 256 decimal bytes. If this is a compare 
(K2) procedure, then this value will be taken from the disk file format labels. 


NOTE: 


FT = O whenever none of the functions in Table 3—2 are specified. Table 3—2 
specifies the functional routine size with the associated parameter or Ujio 
statement. 





UP-8069 Rev. 9 





SPERRY UNIVAC OS/3 
DATA UTILITIES 


Table 3—2. Functional Routine Sizes 


Associated 
Parameter or 
Statement 


Select/Delete SEL/DEL statement | 2030 


Functional 
Routine 


Print Routine ucpure.uor, or bP | 3630 | 


NOTES: 





@ A size is not shown for the copy functional routine (K1 
parameter) because the copy function is included in the base 
size of the formula (17,300 or 24,700). 


@ The field selection routine is automatically included when you 
specify variable record processing with DAM and nonindexed 
files. It is also included if you specify OS/4 to OS/3 processing 
(77 PARAM MODE=OS4). Consequently, the size of this routine 
must be included in your minimum main storage calculations 
when these situations arise. If the DU23-I-INPUT REC LENG 
NOT EQUAL TO OUTPUT REC LENG is displayed, the field 
selection routine will be used to truncate or blank fill the 
INPUT1 records. 


@ The maximum INPUT1 file record size must be added to this 


value. 


® The maximum OUTPUT1/OUTPUT2 file record size must be 
added to this value. 


3-68 
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Table 3—3. 1/O Routine Sizes 
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Ca 
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DAM 
SAM 
ISAM 
Nonindexed 
IRAM 
MIRAM 900 
35 




















Example 1: 
Copy SAM disk file to tape in a basic data management (DTF) environment. 
UDT A=(128,256),B=(128,1024),K1 


B=(17,300+ FT+1IOT+C+D+E+F+Gt+Ht+I+J) 


FT =  O because the copy function is included in the 17,300 base size of the 
formula. 
1lOT = 880 for SAM disk INPUT1 I/O routine 
+ 1380 for tape OUTPUT1 I/O routine 
2260 
C = 128 for INPUT1 record size 


D = _ 256 for INPUT1 block size 
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E 128 for OUTPUT1/OUTPUT2 record size 





F 1024 for OUTPUT1 block size 
G through | are not used for SAM disk files or tape files 
B = (17,300 + 0+ 2260 + 128 + 256 + 128 + 1024) 


B = 21,096 


M = 24,700 or B, whichever is greater 
Since B = 21,096 


M = 24,700 or X‘607C’ bytes required for the DATA routine 


Example 2: 


Copy an ISAM disk file to an ISAM disk file and print the output file using mixed or 
consolidated data management. 





UDD A=(122,256),B=(122,256),DP,OB,OI,PY,TD, V=(20,20),W=(0,0) @ 
NOTES: 


1. The A=( ) parameter is used only to show the INPUT1 record and block sizes. 
These values are from INPUT format labels. 


2. The V=() and W=/() parameter should have only an output entry. The input entries 
are used to show only the INPUT1 key length and key location. These values are 
from the INPUT? format labels. 


B= (17,300 + FT +IOT+C+D+E+F+G+H+I1+J) 


FT = 4700 for PRINT functional routine 
1OT = 950 for ISAM disk INPUT1 I/O routine 
+ 1000 for ISAM disk OUTPUT1 1/0 routine 
1950 
C = 122 for INPUT1 record size 
D = _ 256 for INPUT1 block size 





E = 122 for OUTPUT1 record size 
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II 


@ F 256 for OUTPUT1 block size 


G 


20 for INPUT1 key size 
H = 20 for OUTPUT1 key size 
| and J are not used for ISAM files 
= (17,300 + 4700 + 1950 + 122 + 256 + 122 + 256 + 20 + 20) 


B = 24,746 


M = 24,700 or B, whichever is greater 
Since B = 24,746 


M = 24,746 or X‘60AA’ bytes required for the data utility routine 


Example 3: 
& Compare a card file to a tape file with field select by using basic data management. 


UCT A=(80,80),B=(80,800),OR,K2 
FS1,5,1/6,10,70/20,10,20 


B =(17,300 + FT +10T+C+D+t+E+F+G+H+I1+4 J) 
FT = 2500 for compare functional routine 


3000 for field selection functional routine 
+ 80 for maximum INPUT2 record size 








5580 
1lOT = 510 for card INPUT1 1/O routine 
+ 1380 for tape OUTPUT 1/0 routine 
1890 
C =_ 80 for INPUT1 record size 
D = _ 80 for INPUT1 block size 
E = _ 80 for OUTPUT1/OUTPUT2 record size 
& F = 800 for INPUT2 block size 


G through J are not used for card or tape files. 
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B = (17,300 + 5580 + 1890 + 80 + 80 + 80 + 800) 


> 





B = 25,810 


M = 24,700 or B, whichever is greater 
Since B = 25,810 


M = 25,810 or X’64D2’ bytes required for the data utility routine 
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4. Sample Control Streams 


4.1. PURPOSE AND APPLICATION 


The sample programs in this section illustrate some of the functions of the DATA routine. 
These programs all use the same input data and represent a typical progression for handling 
the data. Selected fields from the input data card deck are written to a work area on disk and 
then the two are compared. The data in the work area is copied to another work area on the 
disk and again these two are compared. The data in the first work area is printed out. 
Finally, one of the records in the data file is corrected. 


The input data deck shown is for illustrative purposes; actual data decks could be 
considerably larger. Figure 2-1 shows a sample control stream using embedded card data. 
All card and disk files used in these examples are in SAM format. Job control statements, 
Uio statements, utility modifier statements, and data decks needed for the job steps are 
included. 


The amount of minimum main storage required for each job step is computed according to 
the specifications shown in 3.4. 


4.2. COPY CARD-TO-DISK OPERATION 


In this example, the employee records of the data deck are copied to a disk file and written 
to the printer file. Some fields of the input file are rearranged by the FS statement, and 
records are deleted by the DEL statement. Also requested is the printing of headings on the 
printer output. 
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Job control stream: 


1 10 20 30 40 50 60 








1. JOB DATAUT, 6686 
2. 1 // DVC 28 // LFD PRNTR 
JOB 3. 1 // DYC 36 // LED ENPUTL 
contro. /!: | // ove 51 // VOL DSP828 
carps \5- | // EXT SQ,C,,CYL,19 
6. | // LBL WORK2 // LFD OUTPUT 
7. | // EXEC DATA 
8. | /$ 
Uio CARD 9. | UCD B8=(98,98).DP,MY,PY,S2 
18.{ FS 1,18,25/15,28,1/45,3,45/55,2,55/65,3,65/78,3,78/1, 18,81 
11.) DEL D=(1),A=(4,1111) 
UTILITY Jao} Wd EMP HOURLY EMP 
MODIFIER 13 SEQ 
CARDS i 
14.1 H2 NAME NO RATE CLASS 
15.1 NG NO 
16.) 7° 
17.1 /& 
18.1 // FIN 
19.) // DATA FILEID=DATAUTINPUTI 
20.) 9968789123 DONAHUE, MARY M 255 16 
21.] 9988776312 GIAGLONE, JOHN K 255 16 
22.) 6608617892 LANGINES, SAMANTHA R 276 11 
23.) 1111777321 LONG, GEORGE A 255 19 
24.) 8890678978 LOTIERZO, HELENE: § 318 13 
DATA /25.| 9808776321 MATHEWS, SAMUEL T 425 15 
CARDS \26.| 6699667843 MATTHEWS, JANE L 278 11 
27.| 6688667712 NORDICK, JOHN M 425 14 
28.) 1111573212 OGALSBY, PETER K 598 15 
29.| 68860673124 PARYIN, THOMAS G 425 14 
30.) 7° 
31.1 // FIN 


Printer output: 


PAGE 909) DATE 75/02/13 


HOURLY EMP EMP 


NAME NQ RalTe CLASS RATING 


DONAHUE, MARY M 9000785123 255 ie} 0230 
GIAGLCNE, JOHN K 9030776212 5 16 is 
LANGINES, SAMANTHA K on90€17892 HM 

LOTIERZO, HELENE § N930€78S 78 

MATHERS, SAMUEL T 90077632) 

MATTHEWS, JANE L GOICEE TEA 

NOROICK, JOHN M NGIGEETII2Z 


PARYIN, THOMAS & DOVE TIIZG 


636 
935 
046 
863 
658 
671 
845 
955 
875 
868 





4-2 


70 80 


EMPX 


RATIX 


129 
125 
138 
135 
148 
145 
158 
155 
168 
165 


120903078912? 
W25NCIGTTIEII2 
1300%5E17852 
34000 J0€78S78 
945 905077632) 
I5G90U5EE TE NR 
ISS ICGGEETIAZ 


1€5 3054673124 
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The job control cards to assign devices, allocate main storage and disk space, and initiate 
the DATA routine are included in the job control stream (cards 1 through 8). The printer 
file, card reader file and disk file are assigned, plus the space SAM with no data 
management disk check function. The input file type is taken from the VTOC. 


The UCD mnemonic of the Uio statement specifies that this is a card-to-disk operation. 
The A keyword parameter is not coded because the default value of 80-byte record and 
block lengths applies. The B keyword parameter specifies the output record and block 
length of 90 bytes. The DP keyword parameter specifies printing of output records. 


The keyword parameters K7 and OS are not coded because their default values apply to 
this job step. K7 specifies a copy operation, and OS specifies that the format of the output 
file is in SAM with no data management disk check function. The input file type is taken 
from the VTOC. 


Keyword parameters MY, PY, and S2 specify to ignore printer mismatches, print page 
numbers and date on the first line of each page, and double-space the printer file output. 
The printer output is written in the /ist format by the default value of the 7L keyword 
parameter. 


The fields beginning in columns 1 and 15 of the card file are moved to different locations 
in the disk file by the specifications in the first two parameters of the FS statement. The 
first field of the card file is repeated in columns 81 through 90 of each record in the 
output disk file by the specifications in the last parameter (card 10). 


The DEL statement (card 11) deletes all records containing the characters 1111 in the first 
four columns of the card file. Therefore, the input data records in cards 23 and 28 are not 
copied to the disk file and do not appear in the printer output. 


Note that the column headings in the Hn statements (cards 12 through 15) are coded five 
positions to the right of their positions shown on the printer output. Within the DATA 
routine, column 5 of Hn statements is considered equal to column 1 (3.3.3). 

The continuation of the title lines is shown in cards 13 and 15. 

The // FIN card is required by spooling at end-of-data cards. 

The // DATA FILEID job control statement on card 19 directs the card reader input to a 
spool file for the job. DATAUTINPUT1 is a concatenation of the job name and the LFD file 


name for the card reader. To spool in the data, key in the command IN at the console. 


The printer output shows that all DATA routine specifications have been executed 
successfully. 
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4.3. COMPARE CARD-TO-DISK OPERATION & 





This example illustrates the programmer messages that result when unequal records are 
compared. 


Job control stream: 


1 19 26 38 46 58 68 78 86 





1. |// JOB DATAUTIL, 6698 
2. |// OVC 28 // LFD PRNTR 
JOB 3. 1// DVC 38 // LFD INPUT! 
CONTROL\ 4. [// DVC 51 // VOL DSP828 
CARDS 75. |// LBL WORK2 // LFD tNPUT2 
6. |// EXEC DATA 
7. 1/$ 
Uio CARD 8. [UCD B=(96,98),K2 
9. |/* 
10.)/8& 
11.1// FUN 
12.)// DATA FILEID=DATAUTIL INPUTI 
13 .} 6686789123 DONAHUE, MARY M 255 16 6386 126 
14 | 6868776312 GIAGLONE, JOHN K 255 18 835 125 
‘15 .| 6688617892 LANGINES, SAMANTHA R 278 11 846 138 
pata /16.[1111777321 LONG, GEORGE A 255 18 863 135 
CARDS \1!7.|8888678978 LOTIERZO, HELENE S 3186 13 658 146 
18 .16668776321 MATHEWS, SAMUEL T 425 15 971 145 
19 .19698667843 MATTHEWS, JANE L 278 11 845 158 
20.18888667712 NORDICK, JOHN M 425 14 655 155 
21.41111573212 OGALSBY, PETER K 568 15 675 166 
22.19968673124 PARYIN, THOMAS G 425 14 668 165 
23. /° 





DONAHLE, MARY M : 120 
00007891 3200000789123 

ED IN COMPARE OF FIL 
GIAGLONE, JOHN 125 


325 0000776312 


LANGINES,. SAMA 


NTHA R 9000 
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3 1300000617892 


€ 
I 
H : 130 
1 
I 


TOMCTOFoOMDrcorerstarc 


ETD bh 4D dG ED wg ZI Loe ay 24 DM ont oe DP wg md ad tt wg EP og TO tg A ng 
Ow ~ Ooms OF B&2® OM oO 


oo mMmMoO wma @;o MM Ww Me 


~~ ste 


@ 
@ 


SAMUEL T 00007 
ECTED IN COMPARE OF 


MATHEBS, SAMUEL 145 
TED ty compareoae 15000906¢ 7843 
MATTHEWS, JANE L 3150 
355 00906€7712 


BV TH AVS VH MAVOVVNVH VHF VOV DS VO VHF VOY, 
ac 


HN JOOCEE 

TED IN COMPARE OF F 
NORDICK, JOHN # . 2155 

i 1650000672324 


oecocecocest o¢ eotecocomc= 
fet =] 


N 
Q 
R 
N 
0 
N 
I 
R 
N 
0 
N 
A 
R 
N 
] 
N 
Q 
R 
Ct 
0 
N 
A 
R 
N 
0 
N 
A 
R 
N 
0 
N 
iy 
R 
N 
0 
N 
A 


1 
i] 
I 
i] 
E 
I 
0 
I 
S 
E 
I 
0 
I 
t 
E 
1 
i 
I 
L 
E 
rf 
0 
I 
4 
E 
I 
Q 
3 
" 
E 
rf 
) 
I 
N 
E 
I 
Q 
I 
P 
ER 
ub 


SBD DG TD 
emzr ny Mme uw Mm 





ed 
mo: 
zm 
ano 
mn Ee 
7 te 
wQia 
z 
Lo FD) 














SPERRY UNIVAC 0S/3 4-5 
DATA UTILITIES 


UP-8069 Rev. 9 


We used our original data deck (cards 12 through 21) to compare the card file to the 
WORK2 area of the disk file. The job control cards assign the printer file, the card reader 
file, disk file, and the WORK2 disk area (cards 2 through 5). 


The UCD mnemonics specify a card-to-disk operation (card 8). The default values of the A 
and OS keyword parameters are assigned. The B keyword parameter specifies 90-byte 
output record and block lengths. A compare operation is specified by the K2 keyword 
parameter. 


The resulting printout shows all records unequal because the first two fields were 
rearranged and a 10-byte field was added to all disk file records during the copy operation. 
If all records were equal, the job step would have terminated normally. 


4.4. COPY DISK-TO-DISK OPERATION 


In this example, the data stored in the WORK2 area of the disk file is copied to another 
area in the same disk file. 


Job control stream: 





1 10 20 30 
1. |// JOB DAMAIX, 6908 
2. |/7 DVC 28 // LFD PRNTR 
3. |// DVC 51 // NOL DSPB28 
JOB 4. |// LBL WORK2 // LFD INPUTI 
CONTROL (5. |// DVC 51 = // VOL DSPH28 
caRDS )6. |// EXT $Q,C,,CYL, 18 
7. |// LBL WORK3 // LFD OUTPUT] 
8. |// EXEC DATA 
9. |/$ 
10. |UDD DP, MY, $2 
11. |/* 
12.1/8& 
13.1// FIN 


Printer output: 


DONAHUE, MARY 


GIAGLONE, JOHN K 


LANGINES» SAMANTHA R 
LOTIERZO, iEL ENE S 
MATHEWS, SAMUEL T 
MATTHEWS, JANE L& 
NQOICK, JOHN M 


PARYIN, THOMAS G 


OCOC789123 
ococ7? 6312 
00 006) 7&92 
00 0067 8578 
OCcOC7T7 6323 
O00C66 7 E43 
000066 7712 


OQCOG67 3324 


4 2€000C7 893 23 
1 2500 0077 6312 
93 (0006617892 
1 4(000C67 8978 
3 4500 0077 63 21 
15 (0000667 843 
1550000667712 


1 650000673124 
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The printer file, the disk file, input WORK2 area, and output WORK3 area are assigned to 
the job step (cards 2 through 7). The output area, WORK3, is allocated by the // EXT 
statement (card 6). 


A disk-to-disk operation is specified by the mnemonic UDD. The input record and block 
lengths are taken from the VTOC, and the output record and block lengths are assumed to 
be equal to the input lengths. We have used the DP keyword parameter to request that 
records copied to the output area, WORK3, be written to the printer file. By using the 
keyword parameters MY and S2, printer mismatches are ignored and the printer Output is 
double spaced. The printer output is printed in the /ist format by the default value of the 7L 
keyword parameter. 


The printer output shows that the complete WORK2 area has been copied to the WORK3 
disk area. 

4.5. COMPARE DISK-TO-DISK OPERATION 

This example shows the job control stream used to compare the data stored in disk 
WORK2 area to the data stored in disk WORK3 area. Any unequal records are listed on 


the printer output. 


Job control stream: 





1 10 20 30 
1. CATUDT, , 6000 
2. |// DVC 28 7/ LED PRNTR_ 
yon \3. |// OVC 51 // VOL DSPB28 
contro. (4: |// LBL WORK2 // LFD INPUT 
aps )3- |// DVC 51 7/ VOL DSPG28 
CARDS 16. |// LBL WORK3 // LFD INPUT2 
7. |// EXEC DATA 
8. |/$ 
Uio CARD 9. | UDD K2 
10.|/* 
11.|/& 
12.|// FIN 


The card reader file, printer file, and disk file are assigned to this job step in the job control 
stream (cards 2, 3, and 5). The WORK2 disk area is defined as INPUT1, and WORK3 disk 
area as INPUT2 (cards 4 and 6). 


A disk-to-disk operation is specified by the UDD mnemonic. The same disk files are used 
for this compare operation as were used for the previous copy operation, so our A and B 
keyword parameter values remain the same, although the value for the A keyword 
parameter is taken from the VTOC for INPUT1 file and the value for the B keyword 
parameter is taken from the VTOC for INPUT2 file. K2 keyword parameter specifies a 
compare operation. 


The printer output shows that all records in disk area WORK2 compare equally to the 
records in disk area WORK3. Had there been unequal records, they would have been 
displayed as they were in 4.2. 
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4.6. COPY DISK-TO-PRINTER OPERATION 


Shown in this example is the job control stream required to write the contents of the disk 
WORK2 area into the printer file. 


Job control stream: 






1 10 20 
1. JOB PRINTED, , 6098 
2. |// DVC 51 
3. |// VOL DSP828 
JOB 4. |// LBL WORK2 
contro. (5. |// LFD INPUTI 
plies 6. |// DVC 28 
7. |// LED PRNTR 
8. |// EXEC DATA 
9. |/$ 
Uio CARD 10.] UDP MY,OB,PY,TD,S2 
fies: 
12.| /& 
13.|// FIN 


Printer output: 


PAGE 0001 OaTE 42/01/78 


PEC# auKkSZ RECSZ eee cceeelOe veces eel evevevee Bove cvecetleescceeeDevevesevblinccre ce Oeeceees 80 


Ooonvao00! no240 Oun80 0000789123 DONAHUE, MARY M 255 10 030 120 
FFF FF FFFFFYY44YCDDCCEC6YDCDE YO44YNY4 444 HHH EF ES YH YH HME PUNY YM YMA 

000078912300004%65 | 8458041 980400000000000000025500000u010000U00000 3000000000001 20 

REC QLKS2Z RECSZ SOeeEVEr eT eer eee eer er orerereren | Perr rerel eee rerel Perr reer re rere re ees]! | 


gvoor0uo002 3j024u O0Nn8BO 0000776312 GIAGLONE, JOHN K 255 ize) 035 125 


FEFFEFFFFEY444CCCCODDCOYDDCOYD A444 44444 HUEY E FEY YHE YAM E PUSHY YQUE EE YY YAH 
000077631 2000079173655801 6850200G00U0000000025500000U0! 0000uc0000;50000000000125 
RECS RECSZ weerce selec cc eee eseccecserSecccceseteveseveeDissecevesbVseseesee Deeseven cll 


vourugoou3 00980 09006147892 LANGINES, SAMANTHA R <70 11 040 130 
FEF FFF EFFFY444DCOCCOCE SYECDCOECCYHD 4444444 SMM E EE YUN YY 4OE EY YM MUM YH YE 


000061789200U031579557802141538109000000000U2700U00UU0! 1000400000 400N00000000130 
seca REcCSZ wecccev el De ncceese2OecevceeedilessccceetevveseceDvvacvcesbigeersseelUveseeee SD 


vourdcoGgu4 oonso 111177732) LONGs GEORGE A 255 10 043 135 
FFFFEFFFFEYY44DDDC OYCCONC CHC HHA 444 EY 44H YH EYE EP YEE EAH HEHE YY 
1111777321000036578075697501U00000000000000025500000U01 0000000004 300000000001 35 

RECS RECSZ weer c eels ence e to 2Occeevccsdeveceseetccesce ee Deve cesesbseevecselOeesveeesf0 


Jsoroug0LUs 0080 0140678978 LOTIERZO, HELENt S 310 13 050 40 
FFFFFEFFFF4Y444DDEC COED SYCCOCDC YE 44444444 YEG EAM YM YH ME ERY HGH OU EAH EAH Y YEE 


01406789780000363559968085 35550200000U000000310U0000U0! 3000Uu00000s500U0U000000F 40 
wEecs ALKS£ RECSZ eecesveel Breer vere ZOecever es Mose svceetsccccceeSiesesesesdsveresseleeevese cD 


vOoCUCOO0S8 yO24L D0N80 0000776321 MATHEWS, SAMUEL T 425 15 071 145 
FEFFEFFFFFY444OCECCEESYECDECDYE 444444444 EMH 4E EE YG YEG 4E EAH AMME FHM YEA YY YUE 


' 0000776321000841 345628021 44530 30UU0U0000000042500000U0! 5000u000007 !uuo00000001 45 
REC# BLKSZL RECSZ er cecs cel Oeecccras2Ovvevcccsduesvcccs eter ececse Dn eccesesOseorasee leveseees BD 


oocn0ucou7y sUu24u 00080 1000667843 MATTHEWS, JANE L 270 hi 045 150 
FFEFFFFFFFY4440CEFCCEE 6YDCOC YD Y 444 4H EYE EGG EEE 44H EG HE E UEGaHE E YHHH UP 

0000667843000041 338562801 1550 3N0UD0LUU00000027000000U0! 1000u00000450u00000000150 

PECs bLKSL RECSZ ee cerrcel Ones ves sa ZOnccceveeecvereseWeeeveseeDevecccsvOigeesvave Uevevere sD 


ogonucoocs gu24u 00080 0000667712 NORCICK, JOHN 425 4 o55 155 
FFFEFEFFFE 444 4D D0CCCOS6YDDCOYD ANIA 444A EIN A SE PAYNE YE YES EE YA E 

000066771 200095694932801 6850400000000000000042500000U0 I 4600u000005Sa0000000000155 

RECS ALKSZ RECSZ weccce eel Beare c sc elOeseceeee terse cseeWeserceseDWacecevssbiasssesestecccees c80 


oo0cd00009 vu24u OOn8a 1111973212 OGALSBY, PETER Kk 500 15 075 160 
FFFFFFFFFF 44440 CCOECESYDCECDYDY 44444444444 44 FE 444444 YY RHE PUY OE 
111157321200g0671322880753590200000U00000000500U0000u015000uU00000750u00000000160 

RECS BLKSZ RECSZ eee elO ecco crea ZOevccccce eee ccc s ste ecccnee Deve seeneGegseveseetOeveseeee80 


uooraooo0lo 90240 90n80 0000673124 PARYIN, THOMAS G 425 14 040 165 
; FFEFFFFFFF4YS44DCOECDE4ECDDCES CYS Y SYNGE YY GNU OE EE NYY YAM HE EAH EG HY ME EF YAY MYM EEE 
000067312400007198958038641 2070000000000000042500000U0 1 4000u00000,400000000000165 
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The WORK2 area of the disk file is assigned as INPUT1 (cards 2 through 5). The mnemonic 
UDP signifies a disk-to-printer operation. A 90-byte record and block length input file is 
specified by values stored in the VTOC. The default values of the B keyword parameter, 
90-byte record length, and 120-byte print line, are acceptable for this job step. Printer 
mismatches are ignored by use of the MY keyword parameter. The output is printed in 
hexadecimal and EBCDIC as specified by the keyword parameter OB. Page numbers and 
dates are printed by specifying the PY keyword parameter. The 7D keyword parameter 
specifies printing the output in the display format. 


4.7. CORRECTION OPERATION 


In this example, we will correct one of the records on the WORK3 area of the disk file by 
using the COR statement. 


The amount of the hourly rate and employee class rating for John K. Giaglone will be 
changed from 255 to 270 for the hourly rate, and from 10 to 11 for the employee class. 
All other information in this record remains the same. 


Job control stream: 





1. 

2. 47// DVC 26 // LFD PRNTR 

3. | // OVC 51 // NOL DSP828 
JOB 4. | // LBL WORK3 // LED INPUTI 
CONTROL (5. | // OVC 51 // VOL DSP828 
CARDS ]6. | // EXT SQ,C,,CYL,19 

7. | // LBL WORK4 //LFD OUTPUTI 

8. | // EXEC DATA 


9. | /$ 
Uio CARD 18.]UDD B=(98,98),MY,OSY 
UTILITY §11.] COR N=(1),A=(2), B=(2) 


MODIFIER 412.| BBB9BGIAGLONE, JOHN K 986677 6312 278 11 635 
CARDS {13. 125 88866776312 

14.] 7° 

15.} /& 

16.) // FIN 


Printer output: 


DCNAHUE, MARY M 0000789123 1200000789123 
GIAGLONE, JOHN K 0000776312 1250000776312 
LANGINES, SAMANTHA R 0000617892 1300000617892 


LOTIERZO, HELENE S 0000678978 1400000678978 


MATHEWS, SAMUEL T 0000776321 1450000776321 


MATTHEWS, JANE L 0000667843 1500000667843 
NCROICK, JOHN M 0000667712 1550000667712 


PARYIN, THOMAS. G 0000673124 1650000673124 
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Device assignment, allocation of main storage and disk space, and initiation of the DATA 
routine are included in the job control cards (cards 1 through 9). Note that card 6 is 
included to allocate disk space for the WORK4 area. This new area on the disk file is 
required because our original area (WORK3) cannot be corrected, but must be written to 
another area while corrections are being made. 


The UDD mnemonic specifies a disk-to-disk operation. The input block and record lengths 
are taken from the VTOC. The 8B keyword parameter specifies that the output record length 
is 90 bytes and the block length is also 90. The records are fixed length. The MY and OSY 
keyword parameters specify that printer mismatches are to be ignored and that the output 
file is in SAM format with a write disk check configured. 


In the COR statement, the keyword parameter WN specifies that one record follows. The 
keyword parameter A specifies that the starting location of the record to be corrected is 
record 2 and the keyword parameter B specifies the ending of the correction (card 11). 
Lines 12 and 13 specify the correction that is to be made to record 2. 


The printer output shows that the corrections to this record have been executed 
successfully. 
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5. DATA Routine Jprocs 


5.1. PURPOSE AND APPLICATION 


A job control procedure (jproc) is a series of job control statements that establishes a 
sequence of steps that lead to the solution of a problem, i.e., the proper control stream 
needed to assign the files and devices used by your job. This jproc eliminates the need to 
repeatedly code identical sequences of job control statements. OS/3 allows you to code a 
single statement (a jproc call statement) that generates the proper job control statement 
sequence for you. 


Sperry Univac supplies a set of jprocs that contains the job control statements that are 
needed to execute the DATA routine. These jprocs are stored in the job control stream 
library file (SY$JCS). In order to use them, you place a jproc call statement in your control 
stream at the point where you would have otherwise placed the job control statements (if 
you had used them). The jproc call statement then generates the proper sequence of job 
control statements, depending on values you supply through positional and keyword 
parameters. (Refer to the job control user guide, UP-8065 (current version) for detailed 
information on writing and calling procedure definitions.) 


The DATA routine jprocs can be used to simplify the job control stream when you run a disk- 
to-disk (UDD), disk-to-tape (UDT), or tape-to-disk (UTD) operation. The jproc call statement 
can also be used when you compare two files. This method can be used to shorten the job 
control stream described in 2.1.12. However, both methods are functionally identical, and 
use of either method is at your discretion. 


5.2. COMBINATION OF FILE TYPES 


Tape or disk files may be copied or relocated to the same volume or to a different volume by 
use of a jproc call statement. Table 5-1 lists the types of input and output files that may be 
copied or compared by a jproc call statement. 
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Table 5—1. File Types Used with Jprocs 


SAM tape, fixed or variable SAM disk, fixed, or variable 
DAM disk, fixed or variable 
ISAM disk, fixed or variable 
IRAM disk, fixed 
MIRAM disk, fixed or variable 
SAM tape, fixed or variable 





DAM disk, fixed or variable SAM disk, fixed or variable 
DAM disk, fixed or variable 
ISAM disk, fixed or variable 
iIRAM disk, fixed 
MIRAM disk, fixed or variable 
SAM tape, fixed or variable 


ISAM disk, fixed or variable SAM disk, fixed or variable 
DAM disk, fixed or variable 
ISAM disk, fixed or variable 
IRAM tape, fixed 
MIRAM disk, fixed or variable 
IRAM disk, fixed 
MIRAM tape, fixed or variable 
SAM tape, fixed or variable 


IRAM disk, fixed or variable SAM disk, fixed or variable 
DAM disk fixed or variable 
ISAM disk, fixed or variable 
IRAM disk, fixed 
MIRAM disk, fixed or variable 
SAM tape, fixed or variable 





MIRAM disk, fixed or variable SAM disk, fixed or variable 
DAM disk, fixed or variable 
ISAM disk, fixed or variable 
IRAM disk, fixed 
MIRAM disk, fixed or variable 
SAM tape, fixed or variable 


SAM tape, fixed or variable SAM disk, fixed or variable 
DAM disk, fixed or variable 
ISAM disk, fixed or variable 
IRAM disk, fixed or variable 
MIRAM disk fixed or variable 
SAM tape, fixed or variable 





NOTE: 


SAM = sequential access method 

DAM = direct access method 

ISAM = indexed sequential access method 

IRAM = indexed random access method 
MIRAM= multiple indexed random access method 
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5.3. JOB CONTROL REQUIREMENTS 

Your operations with job control are simplified with a jproc call statement. The UDD, UDT, 
and UTD statements generate the EXEC job control statement and all other device 
assignment cards you need to run a disk-to-disk, disk-to-tape, or tape-to-disk operation. To 
ensure compatibility between disk and tape unit numbers, the DVCVOL jproc call statement 
assigns logical unit numbers for disk units, and the DVCVTP jproc call statement assigns 
logical unit numbers for tape units. (Refer to the job control user guide, UP-8065 (current 
version).) 


The basic structure of your job control stream when using a jproc call statement is as 
follows: 


1. JOB control statement (// JOB parameters) 

2. Data utilities jproc call statement (// UDD or // UDT or // UTD) 
3. Start-of-data job control statement (/$) 

4. Data utilities control statement (Refer to 2.1.5.) 

5. End-of-data job control statement (/*) 

6. End-of-job control statement (/&) 


7. FIN job control statement (// FIN) 


5.4. JOB CONTROL PROCEDURES 


The three types of job control procedures (UDD, UDT, and UTD) are described in 5.4.1 
through 5.4.3. 
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5.4.1. UDD Job Control Procedure 


Function: 


UDD generates the job control statements for your device assignment sets that are 
required by the DATA routine to copy or compare one disk file to another disk file 
(disk-to-disk operation). 


Format: 
//ignored UDD IN=/(vol-ser-no), label cma [. ACCEPT]\, 
RES $ 
RUN 
OUT=/(vol-ser-no), label eee (ACCEPT 
RES * EXTEND 
RUN INIT 
RELOD 


me) 


‘nn 
wv Niele a 


MI OLD 

NI PRI 

ae SUB 

nn(id) Tcec:hh 
TBLK 
TRK 


(mi » (mj ,..-][,0LD] 
(bi[,ai]) juan | 
(pi%[,ci]) (pi%[,cj]) 
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Label: 
The label field is ignored. 
Parameters: 
{N= 
Supplies the information required to define the input file. The information is 
coded within the parentheses. 


where: 


vol-ser-no 
Specifies the volume serial number of the volume containing the input file. 


RES 
Specifies that the input file is located on the SYSRES. 

RUN 
Specifies that the input file is located on the volume containing the job's 
SYSRUN file. 

label 
Specifies the file identifier for the input file. 

noext 
Specifies the number of extents in the file requiring space to be reserved in 
the prologue. The default value is 8. 

ACCEPT 


Indicates that the data management specifications should be obtained from 
format 1 and format 2 labels in the VTOC. This specification is used for files 
previously opened and closed by data management. 


OUT= 


Supplies information required to define the output file for a copy operation or to 
define a secondary input file for a compare operation. 


where: 


vol-ser-no 


Specifies the volume serial number of the disk containing the output (or 
secondary input) file. 


RES 


Specifies that the output (or secondary input) file is located on the SYSRES 
disk. 


Specifies that the output (or secondary input) file is located on the volume 
containing the job’s S$YSRUN file. 
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label 
Specifies the file identifier for the output (or secondary input) file. 


noext 
Specifies the number of extents in the file requiring space to be reserved in 
the job prologue. The default value is 8. 


ACCEPT 
Indicates that the data management specifications should be obtained from 
format 1 and format 2 labels in the VTOC. This specification is used for files 
previously opened and closed by data management. 


EXTEND 
Indicates that a sequential (SQ) file is to be extended. The information is 
appended to the present end of the file. 


INIT 
Indicates that the specified file is to be initialized starting with the first 
record each time the file is opened. Previous control information in the 
format labels is ignored at the file open time, and the information is 
overwritten by specifications contained in this DVC-LFD sequence at file 
close time. 


RELOD 
Indicates that the specified IRAM or ISAM file is not to be reformatted at file 
open time when the file is being reloaded. 


PRNTR= 
Indicates whether a device assignment set is to be generated for the printer and 
defines the print file. 


where: 
Suppresses the generation of a device assignment set for the printer. The 


device assignment set is to be manually inserted. This allows for the 
insertion of SPL, LCB, and VFB job control statements. 





Specifies the logical unit number for the printer. The default value is 20. 


vol-ser-no 
Provides a 1- to 6-alphanumeric-character remote destination identifier for 
the print file when dealing with remote job entry. 


PUNCH=YES 
Generates the device assignment set for the card punch. This parameter is 
required when the punch dual output feature (DC) is selected on the data control 
card. 
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PUNCH=@@ 
No device assignment set is generated for the card punch. This is the default 
value and need not be specified. 


COMPARE=YES 
Specifies that the compare operation (K2) is selected on the data control card. 
This keyword causes the file name INPUT2 (secondary input) to be generated for 
the file specified by the OU7 keyword parameter. 





COMPARE=46 
Specifies that this is a copy operation. This is the default value and need not be 
specified. 


EXT= 
Specifies the extent specifications to be used when reserving system resources 
for an output file. The information is supplied as a subparameter list enclosed 
within parentheses. 


where: 

DA 

Indicates this is a direct access file. 
IR 

Indicates this is an IRAM or a MIRAM file. 

# 

1s 

Indicates this is an ISAM file. 
MI 


Indicates this is a MIRAM file. 


Indicates this is a nonindexed (DA or SQ) file. 





Indicates this is a sequential file. SQ is the default option. 


nn(id) 
Indicates this file is a member of a split cylinder set, where nn is an SQ, Ni, or 
DA, and {id) is the 2-character set identification. If the first character of the 
set identification is $, the set is a job step temporary work file, and all 
member names must begin with $SCR. Job control automatically deallocates 


the file. 
C 
Indicates that the file must be allocated contiguously. 
F 
Indicates that the file is to be formatted at allocation time. You must select 
BLK for subparameter 4. 
CF 


Indicates that both of the preceding parameters apply for subparameter 2. 
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NOTE: 
If subparameter 2 is omitted (C, F, or CF), none of the previous options apply. 
inc 


Specifies the secondary increment (in cylinders) by which the file is to be 
extended if automatic extension is required. 


6 
Specifies there can be no dynamic extension of the file. 
Indicates one cylinder block increment is specified. 

NOTE: 





If there is no EXT keyword parameter for this file, the value of the most recently 
specified secondary increment is implemented. 


addr 
Specifies the absolute cylinder address where the file is to begin. Allocation 
is specified in terms of cylinders. 


Indicates that allocation is in terms of blocks. This is the default value if no 
allocation type is specified. 


CYL 
Indicates that allocation is in terms of cylinders. 


OLD 
Indicates that the secondary allocation increment (subparameter 3) is 
changed. No additional space is allocated by job control. If specified, it must 
be the last subparameter in the list. 


PRI 
Indicates that this is the primary (extent definition) member of a split 
cylinder set. Subparameter 1 must be nn/(id). 


SUB 
Indicates that this is a subsequent member of a split cylinder set. 
Subparameter 1 must be nn/id). 


Tecc:hh 
Absolute track address (hexadecimal) in cylinder/head format where the file 
is to begin. Allocation is in terms of tracks. 


TBLK 
Allocates space in blocks; actual allocation is in terms of tracks. 


TRK 
Allocates space in tracks. 
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Specifies the number of cylinders to allocate for this file. Subparameter 4 
must be CYL or addr. 


If a split cylinder allocation is to be made, remember that: 


= = If subparameter 4 is PA/ and this is not the first EX7 keyword parameter 
for this file, this option specifies the number of cylinders for this extent. 
The number of tracks is assumed to have been specified on the first 
EXT keyword parameter for the primary member. 


= If subparameter 4 is SUB, this option specifies the number of tracks to 
be allocated to this secondary member of a split cylinder. 


(bi{,ai]) 
This option is used when allocation is in terms of blocks, where b/ is the 
average block length, and a/ is the number of blocks to allocate. If split 
cylinder allocation is made, remember that: 


= = If subparameter 4 is PA/ and this is the first EX7 keyword parameter for 
this file, this option specifies the number of tracks per cylinder to 
allocate for this member and the number of cylinders for all members 
in the extent. 


= ~§=6 lf subparameter 4 is SUB, this option sacrifices the number of tracks 
per cylinder allocated to this member. The number of cylinders is 
omitted. 


(pi%,ci) 
This is split cylinder allocation only. 


= This parameter specifies the number of tracks allocated as a percentage 
of the total number of tracks per cylinder and, if subparameter 4 is PAI, 
the total number of cylinders to allocate to this extent. If subparameter 
4 is SUB, the total number of cylinders may be omitted. 


= The percent sign (%) must be coded as shown. This option is not used 
with regular cylinder allocation. 


Subparameters 6 through n: 


These subparameters are essentially the same as subparameter 5 and are 
used to describe additional extents, where n < 20. This allows you to specify 
up to 16 extents. 


Subparameter n + 1: 


OLD 
Indicates that this extent applies to a previously allocated file. Primary 
members specified by this keyword parameter will be allocated by job 
control and added to the existing file. If this parameter is omitted, the 
request is for a new extent. 
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Example 1a: 


This example illustrates a SAM disk to SAM disk copy operation using the UDD jproc 
call statement for a simple disk-to-disk copy. It is assumed that space has been 
previously allocated for the output file. In this example, the input and output files are 
on the same disk. 





1. 
Be 
3. 
4. 
5. 
6. 
7. 
Line Explanation 
1 Indicates the name of the job is DCDCCPY1 
2 Indicates the name of the jproc being called is UDD. The /N keyword 


parameter indicates the file identifier (.ABEL1) of the input file and the file 
and serial number (DSPOO1) of the disk where the file is located. The OUT 
keyword parameter indicates the file identifier (LABEL2) of the output file 
and the volume serial number (DSPOO1) of the disk where the file is located. 


Since the file is assumed to be previously allocated, /M/7 is used to indicate 
that any information that may be on the file is to be overwritten by the new 


information. 
3 Indicates the start of data 
4 Indicates the data utility control statement. The input and output file type 


are both defaulted to the input file type specified in the VTOC, and the 
default block size and record size for input and output are 80. 


5 Indicates the end of data 
6 Indicates the end of the job 


7 Indicates termination of card reader operation 
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This example illustrates the expanded job stream generated by example 1a. 


// JOB 


-|// DVC 
.|7/7 LFD 
-|7/7 DVC 
-|77 VOL 
~|/77 LBL 
~|/7/7 LFD 
.{// DVC 
.|/7/ VOL 
{7/7 LBL 
.{// LFD 
-|//7 EXEC DATA 


2A-2B 


2C-2F 


2G-2J 


2K 


10 20 





pcpccPy1 
28 

PRNTR 

58 
DSP#61 
LABEL1 
INPUT1 
58 
DSP881 
LABEL2 
OUTPUT1,, INIT 


Explanation 
Same as for example 1a 


These lines assign the printer to the job. The default logical unit number is 
20 for this example. 


Indicates that the input file has a file identifier of LABEL1 and a file name of 
INPUT1 and is located on the disk with volume serial number DSPOO1. This 
information is obtained from the /V keyword parameter in line 2 of example 
1a. Volume serial number DSPOO1 is assigned to logical unit number 50. 


Indicates that the output file has a file identifier of LABEL2 and a file name 
of OUTPUT1 and is on the same volume as the input file (DSPOO1). The 
same logical unit number is assigned (50). This information is obtained from 
the OUT parameter in line 2 of example 1a. 

This line loads the DATA routine from $YSLOD. 


Same as for example 1a 
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Example 2a: 


oon Don SP Wh 


This example illustrates a DAM-to-DAM disk copy using the UDD procedure call 
statement. Space for the output file is allocated to the file in this job (but before 
execution). The input file is printed in single-space display format as it is being 
copied. 


1 10 20 30 40 50 60 72 





// 30B DCDCCPY2 


// UDD IN=(DSPO61,LABEL1), X 
//\ OUT=(DSP862,LABEL2), x 
//2 EXT=(DA,C,,CYL,3) 

/$ 

UDD 0D,DP 

Ft 

/& 

// FIN 

Line Explanation 

1 Indicates the name of the job is DCDCCPY2 

2 Indicates the name of the jproc being called is UDD. The /N keyword 


parameter indicates the file identifier (LABEL1) of the input file and the 
volume serial number (DSPOO1) of the disk where the file is located. 


3 Indicates a continuation of the UDD jproc call. The OUT keyword parameter 
indicates the file label (LABEL2) of the output file and the volume serial 
number (DSPOO2) of the disk where the file is located. 

4 Indicates further continuation of the UDD procedure call; space for the file is 
to be allocated on the output disk. This line supplies information required to 
allocate the file. 

5 ' Indicates the start of data 

6 Data utility statement; the disk input file characteristics are taken from the 
VTOC. The OD keyword indicates the output file is a DAM file. The DP 
keyword indicates the input file is to be printed in addition to the output file. 
The default block and record sizes for input and output are 80. 

7 Indicates the end of data 


8 Indicates the end of job 


9 Indicates the termination of card reader operation 
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Example 2b: 


This example illustrates the expanded job stream generated by example 2a. 


1 10 20 30 40 50 60 72 





1. |// JOB DCDCCPY2 
2A. 1// DVC 28 

2B. |// LFD PRNTR 
2C. 1// DVC 58 

2D. |// VOL DSP#81 
2E. |// LBL LABELI 
2F.|// LFD INPUT 
2G. j// DVC 51 

2H. |// VOL DSPHH2 
21. |// EXT DA,C,,CYL,3 
24. |// LBL LABEL2 
2K. |// LFD OUTPUT1 
2L. |// EXEC DATA 


UDD 0D,DP 


Line Explanation 
1 Same as for example 2a 


2A-2B These lines assign the printer to the job. The default logical unit number is 
20 for this example. 


2C-2F Indicates that the input file has a file identifier of LABEL1 and a file name of 
INPUT1 and is on the disk with volume serial number DSPOO1. This 
information was obtained from the /N keyword in line 3 of example 2a. The 
volume is assigned to logical unit number 50. 


2G, 2H, Indicates that the output file has a file identifier of LABEL2 and a disk 

2J volume serial number of DSPOO2. This information was obtained from the 
OUT keyword parameter in line 3 of example 2a. The volume is assigned to 
logical unit number 51. 

2i Indicates that space is to be allocated for a direct access file, and three 
contiguous cylinders are required. This is obtained from line 4 of example 
2a. By default, one cylinder is provided for dynamic extension. 

2K Indicates the file name for the output file is OUTPUT1 

2L Indicates the DATA routine is loaded from $Y$LOD 


5-9 Same as for example 2a 
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Example 3a: 





This example illustrates an ISAM-to-ISAM disk copy using the UDD jproc calli | 
statement for disk-to-disk copy of an ISAM file. The input and output files have 

identical file identifiers, but are on different disk volumes. It is assumed that space 

has been previously allocated for the output file. 


1 10 20 30 40 50 











1. |// JOB DCDCCPY3 
2. {// UDD IN=(DSP881, LABEL1) ,OUT=(DSP962,LABEL1,, INIT) 
3. I/$ 
4. JUDD B=(88,852),V=(5),W=(38),01 
5. |/* 
6. 1/8 
7. |// FIN 
Line Explanation 
1 Indicates that the name of the job is DCDCCPY3 
2 Indicates the name of the jproc being called is UDD. The /N keyword 
parameter indicates the file identifier (.ABEL1) of the input file and the 
volume serial number (DSPOO1) of the disk where the file is located. The 
OUT keyword parameter indicates the file identifier (LABEL1) of the output 
file and the volume serial number (DSPOO2) of the disk where the file is 
located. Since the file is assumed to be previously allocated, /N/7 is used to 
indicate that any information that may be on the file is to be overwritten by 
the new information. 
3 Indicates the start of data 
4 Indicates the data utility control statement. The input file characteristics are 
taken from the VTOC. The O/ keyword indicates the output file is also ISAM. 
The B parameter indicates the output record size is 80 and the block size is 
852.-The V parameter indicates the key length is 5, and the W parameter 
indicates a key location of 30 for the output file. 
5 Indicates the end of data 
6 Indicates the end of job 


7 Indicates the termination of card reader operation 
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Example 3b: 


This example illustrates the expanded job stream generated by example 3a. 


1 10 20 30 





1. |// JOB DCCPY3 
2A.|// DVC 28 
2B.1// LFD PRNTR 
2€.1// DVC 58 
2D.|// VOL DSP#G1 
2E.)// LBL LABEL] 
2F.|// LFD tNPUTI1 
2G./// DVC 51 
2H.|// VOL DSPB82 
21. ]// LBL LABEL! 
23.]// LFD OUTPUTI, , INIT 
2K.1// EXEC DATA 


3. |/$ 
4. JUDD B=(8@,852),V=(5),W=(38),01 
5. j* 
6. |/& 
7. |// FIN 
Line Explanation 
1 Same as for example 3a 


2A-2B These lines assign the printer to the job. The default logical unit number is 
20 for this example. 


2C-2F Indicates the input file has a file identifier of LABEL1 and a file name of 
INPUT1 and is located on the disk with volume serial number DSPOO1. This 
information was obtained from the /N keyword in line 2 of example 3a. 
Volume serial number DSPOO1 is assigned to logical unit number 50. 


2G-2J Indicates the output file also has a file identifier of LABEL1 and is located on 
the disk with volume serial number DSPOO2, which is assigned to logical 
unit number 51. This information is obtained from the OUT keyword 
parameter in line 2 of example 3a. The file name is OUTPUT1. 

2K Indicates the DATA routine is to be loaded from $Y$LOD 


3-7 Same as for example 3a 
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This example illustrates a SAM disk-to-disk compare operation using the UDD jproc 
call statement. In this example, the user chooses to define a printer other than logical 
unit 20 for the printed output. 


10 20 30 40 50 60 72 





// JOB DCDCOMP 


// 


UDD IN=(DSPO01, LABEL1) ,OUT=(DSP8H2,LABEL2), X 
COMPARE=YES , PRNTR=21 


Explanation 
Indicates the name of the job is DCDCOMP 


Indicates the name of the jproc being called is UDD. The /N keyword 
parameter indicates the file identifier (LABEL1) of the input file and the 
volume serial number (DSPOO1) of the disk where the input file is located. 
The OUT keyword parameter gives information on the secondary input file 
(the file to be compared against the input file) and indicates the file identifier 
is LABEL2. The volume serial number (DSPOO2) for the disk containing this 
file is also given through the OUT parameter. The COMPARE parameter 
indicates this is a comparison operation instead of a copy operation. The K2 
option must also be selected on the data utility control statement. The 
PRNTR keyword indicates the printer is to be assigned to a logical unit 
number of 21. 


Indicates the start of data 


Indicates the data utility control statement. The K2 option specifies this is a 
compare operation. All input file characteristics are taken from the VTOC. 


Indicates the end of data 
Indicates the end of the job 


Indicates that card reader operation is terminated 
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This example illustrates the expanded job stream generated by example 4a. 


// JOB 


-|// DVE 
-|// LFD 
.|7/ DVC 
-|7/7 VOL 
[7/7 LBL 
.|//7 LFD 
.|7/7 DVC 
{7/7 VOL 
{7/7 UBL 
.|/7/ LFD 
-|77 EXEC DATA 


2A-2B 


2C-2F 


2G-2J 


2K 





INPUT2 


Explanation 

Same as for example 4a 

Assigns a printer with logical unit number of 21 to the job 

Indicates the input file has a file identifier of LABEL1 and a file name of 
INPUT1 and is located on the disk with volume serial number DSPOO1. This 
information was obtained from the /N parameter. The logical unit number 50 
is assigned to DSPOO1. 

Indicates the secondary file has a file identifier of LABEL2 and a file name 
of INPUT2 and is located on the disk having a volume serial number of 


DSPOO2. This information was obtained from the OUT and COMPARE 
parameters. 


Loads the DATA routine from $YSLOD 


Same as for example 4a 





UP-8069 Rev. 9 SPERRY UNIVAC OS/3 5-18 
; DATA UTILITIES 





Example 5a: 


This example illustrates an IRAM-to-IRAM disk copy using the UDD jproc call 
statement for a disk-to-disk copy of an IRAM file. Identical file identifiers are used for 
the input and output files, but the files are located on different volumes. Space for the 
output file has been allocated. 


1 10 20 30 40 50 





1. |// JOB DCDCCPY4 
2. |// UDD IN=(DSP863, LABEL2) , OUT=(DSPO84,LABEL2,, INIT) 
3. I/$ 
4. |UDD B=(88,888),V=(6),W=(38),ORY=(1) 
5. |/* 
6. |/& 
7. |// FIN 
Line Explanation 
1 Indicates the name of the job is DCDCCPY4 
2 Indicates the name of the jproc being called is UDD. The /N keyword 
parameter indicates the file identifier (LABEL2) of the input file and the 
volume serial number (DSPOO3) of the disk where the file is located. The 
OUT keyword parameter indicates the file identifier (LABEL2) of the output 
file and the volume serial number (DSPOO4) of the disk where the file is 
located. The file is assumed to be previously allocated, therefore /N/7 is used 
to indicate that any information currently on the file is overwritten by the 
new information. 
3 Indicates start of data 
4 Indicates the data utility control statement. The input file characteristics are 
taken from the VTOC. The ORY=(/) keyword parameter indicates the output 
file is indexed and has data management disk write checking. The index 
block size for the output file defaults to one 256-byte sector. The B 
parameter indicates the output record size is 80 bytes and block size is 800 
bytes. The V parameter indicates the key length of the output IRAM file is 6. 
The W parameter indicates that the key location of the output IRAM file is 
30. 
5 Indicates end of data 
6 Indicates end of job 


7 Indicates termination of card reader operations 
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Example 5b: 


This example illustrates the expanded job stream generated by example 5a. 


1 10 20 30 40 





1. |// JOB DCPCCPY4 
2A.)// OVC 286 
2B.1)// LFD PRNTR 
2C.|// DVC 68 
2D.]// VOL DSP883 
2E.]// LBL LABEL2 
2F.1)// LFD INPUT 
2G.1// DVC 88 
2H.]// VOL DSP#O4 
21.]//7 LBL LABEL2 
2J.]// LFO OUTPUT1,, INIT 
2K.|// EXEC DATA 


3 /$ 
UDD B=(88,898),V=(6),W=(38),ORY=(1) 
5. |/* 
6. |/& 
7. |// FIN 
Line Explanation 
1 Same as for example 5a 


2A-2B These lines assign the printer to the job. 


2C-2F Indicates the input file has a file identifier of LABEL2 and a file name of 
INPUT1, and is located on the disk with volume serial number DSPOO3. This 
information was obtained from the /N keyword parameter in line 2 of 
example 5a. Volume serial number DSPOO3 is assigned to logical unit 


number 60. 


2G-2J Indicates output file also has a file identifier of LABEL2 and is located on the 
disk with volume serial number DSPOO4, which is assigned to logical unit 
number 80. This information is obtained from the OUT keyword parameter 


in line 2 of example 5a. The file name is OUTPUT1. 
2K Indicates the DATA routine is to be loaded from $Y$LOD 


3-7 Same as for example 5a 
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5.4.2. UDT Job Control Procedure 

Function: 
UDT generates the job control statements for your device assignment sets that are 
required by the data utility routine to copy or compare a disk file to a tape file (disk-to- 
tape operation). 


Format: 


//ignored UDT (es ser-no yew ig i | 
RES 


RUN 
(ju vol-ser- ") 


OUT=(vol-ser-no, ,PRNTR= ( 





Label: 
The label field is ignored. 
Parameters: 


IN= 
Supplies the information required to define the input file. This information is 
coded within the parentheses. 


where: 


vol-ser-no 
Specifies the volume serial number of the disk volume containing the input 
file. 


RES 
Specifies that the input file is located on the SYSRES disk. 


RUN 
Specifies that the input file is on the volume containing the job’s $Y$RUN 
file. 


tabel 
Specifies the file identifier for the input file. 


noext 
Specifies the number of extents in the file for which space must be reserved 
in the prologue. The default value is 8. 


ACCEPT 
Indicates that the data management specifications should be obtained from 
the format 1 and format 2 labels on the VTOC. This specification is used for 
files previously opened and closed by data management. 
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OUT= 
@ Supplies information required to define the output file for a copy operation or a 
secondary input file for a compare operation. The information is coded within 
parentheses. 
where: 


vol-ser-no 
Indicates the volume serial number of the disk containing the output (or 
secondary input) file. 


label 
Specifies the file identifier for the output (or secondary input) file. 


PRNTR= 
Indicates whether a device assignment set is to be generated for the printer and 
defines the print file. 


where: 
Suppresses the generation of a device assignment set for the printer. The 


device assignment set is to be manually inserted. This allows for the 
insertion of LCB, SPL, and VFB job control statements. 





Specifies the logical unit number for the printer. The default value is 20. 


vol-ser-no 
Provides a 1- to 6-alphanumeric-character remote destination identifier for 
the print file when dealing with remote job entry. 


PUNCH=YES 
Generates a device assignment set for the punch. This function is required when 
the card punch dual output feature (DC) is selected on the data control card. 









PUNCH=86. 
No device assignment set is generated for the punch. This is the default value 
and need not be specified. 


COMPARE=YES 
Specifies that the compare operation option K2 will be selected on the data 
control card. This keyword causes the file name INPUT2 (secondary input) to be 
generated for the file specified by the OUT keyword parameter. 


Specifies that this is a copy operation. This is the default value and need not be 


& specified. 





UP-8069 Rev. 9 SPERRY UNIVAC OS/3 5-22 
DATA UTILITIES 





Example ta: 


This example illustrates a SAM disk-to-tape copy operation using the UDT jproc call 
statement for copying a SAM disk to a standard labeled tape. The first 80 characters 
of each record are to be punched. 


1 10 20 30 40 50 





1. | // JOB DCTP#1 
2. | // UDT IN=(DSPOH1, LABEL1) ,OUT=(SP8001,LABEL2),PUNCH=YES 
3. | /$ 
4. | UDT DC,OR,LO 
5. st 
6. | /& 
7. |// FIN 
Line Explanation 
1 Indicates the name of the job is DCTPO1 
2 Indicates that the name of the jproc called is UDT. The /N parameter indicates 
the file identifier (LABEL1) of the input file and the volume serial number 
(DSPO01) of the disk where the file is located. The OU7 keyword parameter 
indicates the tape file identifier is LABEL2 and tape volume serial number is 
SPO001. The PUNCH parameter indicates that the DC keyword parameter 
(Table 2-1) is used on the data utility control statement; therefore output is 
also punched. 
3 Indicates the start of data 
4 This is a data utility control statement indicating the disk input and tape 
output parameters. The DC parameter indicates punched output in addition 
to tape output. The OA parameter indicates the tape is to be rewound before 
and after processing. The LO parameter indicates standard tape labels are 
used. The default block size and record size for input and output are 80. 
5 Indicates the end of data 
6 Indicates the end of the job 


7 Terminates the card reader operation 
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This example illustrates the expanded job stream generated by example 1a. 


// J0B 


.|7/ DVC 
.|//7 LED 
.|7/7 DVC 
. {77 VOL 
~{77 LBL 
.|7/7 LFD 
.17/ DVC 
-|//7 VOL 
-|7/ LBL 
.|//7 LED 
.|// DVC 
_|// LFD 
.|//7 EXEC DATA 


2A-2B 


2C-2F 


2G-2J 


2K-2L 


2M 


3-7 





OUTPUT1 
49 
OUTPUT 2 


Explanation 

Same as example 1a 

Assigns the printer to this job. The default logical unit number 20 is used. 
Indicates the input file has a file identifier of LABEL1 and a file name of 
INPUT1 and is located on the disk having volume serial number DSPOO1. 
The volume (DSPOO1) is assigned to logical unit number 50. This 
information was obtained from the /N keyword in line 2 of example 1a. 
Indicates the output file has a file identifier of LABEL2, a file name of 
OUTPUT1, and a tape volume serial number of SPOOO1. The volume is 
assigned to logical unit number 90. This information was obtained from the 


OUT keyword in line 2 of example 1a. 


Assigns the card punch (logical unit number 40) to the job. The file name is 
OUTPUT2. 


Loads the DATA routine from S$Y$LOD 


Same as example 1a 
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5.4.3. UTD Job Control Procedure 


Function: 





UTD generates the job control statements for your device assignment sets that are 
required by the data utility routine to copy or compare a tape file to a disk file (tape- 
to-disk operation). 


Format: 


//ignored UTD IN=(vol-ser-no,label), 


OUT=/7 vol-ser-no),tabel Bm aaee /{ ACCEPT 
{aes x EXTEND 
RUN INIT 


RELOD 
N 


, PRNTR= an [,vol-ser-no] ee ; COMPARE= (#0 
( : } [ il YES ] 


V EXT= 





addr 


ed 


OLD 
Tecce:hh 
TBLK 
TRK 


Cee ameahl ie 





Label: 


The label field is ignored. 
Parameters: 
1N= 


Supplies the information required to define the input file. This information is 
coded within the parentheses. 


where: 


vol-ser-no 

Specifies the volume serial number of the volume containing the input file. 
label 

Specifies the file identifier for the input file. 


OUT= 


Supplies the required information to define the output file for a copy operation or ® 
secondary input for a compare operation. 
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where: 


vol-ser-no 
Provides the volume serial number of the disk containing the output file (or 
secondary input). 


RES 
Indicates the output (secondary input) file is located on the SYSRES disk. 


RUN 
Indicates the output (secondary input) file is located on the volume 
containing the job’s $Y$RUN file. 


label 
Specifies the file identifier for the output (or secondary input) file. 


noext 
Specifies the number of extents in the file to be reserved in the extent table 
storage for use by the data access method. The default value is 8. 


ACCEPT 
Indicates that the data management specifications should be obtained from 
format 1 and format 2 labels in the VTOC. This specification is used for files 
previously opened and closed by data management. 


EXTEND 


Indicates that a sequential (SQ) file is to be extended. The information is 
appended to the present end of the file. 


INIT 
Indicates that the specified file is to initialize starting with the first record 
each time the file is opened. Previous control information in the format 
labels is ignored at file open time and is overwritten by specifications 
contained in this DVC-LFD sequence at file closure time. 


RELOD 
Indicates that the specified IRAM or ISAM file is not to be reformatted at file 
open time when the file is being loaded. 


PRNTR= 


Indicates whether a device assignment set is to be generated for the printer and 
defines the printer file. 


where: 
Suppresses the generation of a device assignment set for the printer. The 


device assignment set is to be manually inserted. This allows for the 
insertion of SPL, LCB, and VFB job control statements. 


{en} 





Specifies the logical unit number for the printer. The default value is 20. 
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vol-ser-no 
Provides a 1- to 6-character remote destination alphanumeric identifier for 
the print file when dealing with remote job entry. 





PUNCH=YES 
Generates a device assignment set for the punch. This is required when the 
punch dual output feature (DC) is selected on the data utility control card. 


PUNCH=8 
No device assignment set is generated for the punch. This is the default value 
and need not be specified. 





COMPARE=YES 
Indicates that compare operation option K2 is selected on the data utility card. 
This keyword generates a file name of INPUT2 (secondary input) for the file 
specified by the OU7 parameter. 


COMPARE=WOl 
Specifies that this is a copy operation. This is the default value and need not be 
specified. 


EXT= 
Supplies the extent specifications to be used when reserving system resources 
for an output file. The information is supplied as a subparameter list enclosed in 
parentheses. 





where: 
DA 
Indicates this is a direct access file. 


Indicates this is an IRAM or a MIRAM file. 


Indicates this is an ISAM file. 


MI 
Indicates this is a MIRAM file. 


NI 
Indicates this is a nonindexed (DA or SQ) file. 





Indicates this is a sequential file and is the default option. 
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C 
Indicates the file must be allocated contiguously. 
F 
Indicates the file is to be formatted at allocation time. Subparameter 4 must 
be BLK. 
CF 
Indicates both of the preceding parameters apply to subparameter 2. 
NOTE: 


If this parameter is omitted (C, F, or CF), none of the previous options apply. 


Specifies the secondary increment (in cylinders) by which the file is to be 
extended if automatic extension is required. 


Indicates that there can be no dynamic extension of the file. 





Indicates an extension of one cylinder increment of the file. 
NOTE: 


If there is no EXT keyword parameter for this file, the value of the most recently 
specified secondary increment is used. 


addr 
Specifies the absolute cylinder address where the file is to begin. The 
allocation is in terms of cylinders. 





Indicates that the allocation is in terms of blocks. This is the default 
parameter. 


CYL 


Indicates that the allocation is in terms of cylinders. 


OLD 
Indicates that the secondary allocation increment is changed (subparameter 
3). No additional space is allocated by job control. If specified, this must be 
the last subparameter in the sublist. 


Tecc:hh 
Absolute track address (hexadecimal) in cylinder/head format where the file 
is to begin. Allocation is in terms of tracks. 


TBLK 
Allocates space in blocks; actual allocation is in terms of tracks 
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TRK 


Allocates space in tracks. 


mi and mj 
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Specify the number of cylinders to allocate for this file. Subparameter 4 must 
be CYL or adar. If split cylinder allocation is made, remember: 


(bi,ai) a 


If subparameter 4 is PA/ and this is not the first EX7 keyword parameter 
for this file, this option specifies the number of cylinders for this extent. 
The number of tracks is assumed to have been specified on the first EXT 
keyword parameter for the primary member. 


If subparameter 4 is SUB, this option specifies the number of tracks to be 
allocated to this secondary member of a split cylinder. 


nd (bj,aj) 


These options are used when allocation is in terms of blocks, where b/ and bj 
are the average block length, and a/ and aj are the number of blocks to 
allocate. If split cylinder allocation is made, remember: 


If subparameter 4 is PA/ and this is the first EX7 keyword parameter for 
this file, this option specifies the number of tracks per cylinder to allocate 
to this member and the number of cylinders for all members in the 
extent. 


If subparameter 4 is SUB, this option sacrifices the number of tracks per 
cylinder allocated to this member. The number of cylinders is omitted. 


Subparameters 6 through n: 


Specified in the same format as subparameter 5 and used to describe 
additional extents, where n < 20. This allows you to specify up to 16 extents. 


Subparameter n+1: 


OLD 


Indicates this extent applies to a previously allocated file. Primary 
members specified by this keyword parameter are allocated by job 
control and added to the existing file. If this parameter is omitted, the 
request is for a new extent. 
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“SOO RP WD = 
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This example illustrates a SAM tape to ISAM disk copy using the UTD procedure call 
statement. The operation uses variable-length records. It is assumed the disk area has 
been previously allocated. 


1 


10 20 30 40 50 





// JOB TPDCH1 
// UTD IN=(SP681,LABEL1),OUT=(DSP881,LABEL2,,INIT) 


/$ 


UTD A=(5,89),01,FV,LO 


Explanation 
Indicates the name of the job is TPDCO1 


Indicates the name of the jproc being called is UTD. The /N parameter 
indicates the tape file identifier is LABEL1 and the tape volume serial 
number is SPOO1. The OUT keyword parameter indicates that the disk file 
identifier is LABEL2 and the volume serial number is DSPOO1. Since the file 
is assumed to be previously allocated, /N/7 is used to indicate that any 
information that may be on the file is to be overwritten by the new 
information. 


Indicates the start of data 

Specifies a data utility control statement indicating tape input and disk 
output. The FV parameter indicates that records are of variable length. The 
A parameter indicates the maximum block size is 89, and the minimum 
record size is 5. With the B parameter not specified, maximum block size 
defaults to the maximum block size for input. The O/ parameter indicates the 
output is ISAM. The LO parameter indicates the tape has standard labels. 
Indicates the end of data 

Indicates the end of the job 


Terminates the card reader operation 
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This example illustrates an expanded job stream generated by example 1a. 





1. |// JOB TPDC#1 


2A.]// DVC 


2B.|// LFD PRNTR 
2C.|// OVC 96 
20.1// VOL SP881 


2E.}// LBL LABEL1 
2F.1// LFD INPUTL 
26./// DVC 58 
2H.|// VOL DSP8#81 
21.]// LBL LABEL2 
2).4// LED OUTPUT1,, INIT 
2K.]// EXEC DATA 
3 /$ 
. JUTD A=(5,89),01,FV,LO 
5. 1/* 
6. |/& 
7. |// FIN 
Line Explanation 
1 Same as for example 1a 
2A-2B Assigns the printer to the job. The default logical unit number 20 is used. 
2C-2F Indicates the input file has a file identifier of LABEL1 and a file name of 
INPUT1 and the tape volume serial number is SPOO1. It is assigned logical 
unit number 90. This information is obtained from the /V keyword parameter 
in line 2 of example 1a. 
2G-2J Indicates the output file has a file identifier of LABEL2, a file name of 
OUTPUT1, and a volume serial number of DSPOO1. It is assigned logical unit 
number 50. This information is obtained from the OUT parameter in line 2 
of example 1a. 
2K Loads the DATA routine from $Y$LOD 
3-7 Same as for example 1a 




















PART 3. FILE PROCESSING IN AN INTERACTIVE 
ENVIRONMENT | 











SY 
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6. Interactive Data Utility 


6.1. USING THE UTILITY 


The interactive data utility allows you to interactively execute the DATA routine by using 
mixed or consolidated data management files. This interactive execution consists of a dialog 
(question and answer session) that you conduct with the DATA routine via a workstation. 
During the dialog, questions are displayed on the workstation screen and you answer them 
by typing in the requested information via the workstation keyboard. The answers define the 
file processing requirements for the DATA routine. 


To use the interactive data utility, you should become familiar with keyins and 
workstation responses. See 7.4 of the screen format services concepts and facilities, 
UP-8802 (current version), for workstation operator considerations. 


When using the interactive data utility on a remote communications terminal, you must 
have the field protect feature. If this feature is not used, an SF16 error message is issued. 


To conduct an interactive dialog, you must first log on the system by entering the LOGON 
command. After you have successfully logged on, enter the RV |I@DATA command at your 
workstation keyboard. The format of the I@DATA command is: 


RV 1[@ DATA(new-name ) [ aah petetee es) [ Mt | 


where: 


RV 
Indicates the job is to be run without the use of a card reader (interactively). 


|@DATA( new-name) 
Specifies the job name for the interactive data utility. If you specify the optional 
new-name parameter, this name becomes the job name for the utility. Since every 
job name must be unique, the use of the new-name allows for multiple users. 


MEM=nnnoan 
Specifies the required amount of main storage (hexadecimal). The default value 
8000,, (32,767,.) is sufficient for most processing; however, certain functions 
requiring tape or disk files may require more storage. The formula for determining 
the minimum amount of main storage is described in 3.4. 
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ACT=act-no 
Indicates a 1- to 4-character alphanumeric function assigned to you for job 
accounting purposes. 


DBG=/Y 






Specifies debug mode, which is used to provide documentation in reporting a 
software user report (SUR). Specify Y to run the DATA routine in debug mode. If 
omitted, N is assumed. The debug mode increases interactive response time. 


Once you have successfully initiated the execution, your workstation screen clears and the 
first menu selection screen is displayed. This screen asks you what you want to do. 
Depending on your response, the next menu selection screen or a HELP screen (a detailed 
explanation of the options used in the menu screen) appears. 


To make a choice or to request HELP, you must enter the requested information via the 
workstation keyboard and then press the transmit (XMIT) key. 


6.2. OUTPUT LISTINGS 


The same types of output listings (printer formats and termination information) that are 
provided in the batch environment (2.3) are also provided in the interactive environment. 
The only difference is that the termination information is displayed on the workstation that 
initiated the dialog. 


6.3. TERMINATION INFORMATION 


When you execute a program in this environment, the format of the termination 
information for card, tape, and printer files is: 


es INPUT1/OUTPUT1 


INPUTL/OUTPUTIL...(FILENAME).............. [iar 


RECORD ‘SUZ ec ccciaie wir etea cae a ote eas oeay ee bie ade aie nnnnn 
BLOCK/BUFFER SIZE...................0-0008. nnannn 
RECORD FORMAT............... 0... ee ee eee FIXBLK 
FIXUNB 
VARBLK 
VARUNB 
FILE ORG...... ee eee ee eee ee ie SAM 











UP-8069 Rev. 9 SPERRY UNIVAC O0S/3 6-2a 














DATA UTILITIES Update A 
INPUT2 
INPUT2...(FILENAME)..........-... 002 ee eee CARD 
TAPE 
PRINTER 
RECORD: (Sili2 Enos ttn etre oie eat cys He Oe ees nonnn 
BLOCK/BUFFER SIZE.......... 2.0002 eee eee eee nanan 
RECORD FORMAT... 2... .. 2... eee ee eee ee FIXBLK 
FAXUNB 
VARBLK 
VARUNB 


FILE ORG. .SAM RCDS UNEQUAL.............. Annnnnnna 
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The format of the termination information for MIRAM disk and diskette files is: 


a =INPUT1/OUTPUT1 


INPUTL/OUTPUT1..(FILENAME)................ DISK 
RECORD SUZE. wa see cee hae eo OE ee Ewes nnnon 
BLOCK/BUFFER SIZE.................... 00 cee nnnon 
MIRAM KEY Loc LEN CHG DUP 
KEY1 nnnann nannn Y/N Y/N 
KEY2 nnonan nannn Y/N Y/N 
KEY3 nnnan nnann Y/N Y/N 
KEY4 nonnn nnnann Y/N Y/N 
KEY5 nnnnn nannna Y/N Y/N 
INDEX BUFFER SIZE................... 0.0 ae nnnannon 
RECORD CONTROL BYTE...................... re 
ne 
RECORD SLOT SIZE....... 0... ee nnann 
DISK SECTOR SIZE................0......00- nnnann 
VOLUME MOUNT SETTING..................... SINGLE 
ee | 
RECORD FORMAT.............. 00... canes FIXBLK 
Cane 
BUGE ORG oes ee dance Rawat ee haa wes as fe MIRAM(CONSEC 
INDEX 
MIXED 
a INPUT2 
INPUT2.......... (FILENAME)................ DISK 
RECORD SIZE ink Aeeetes adoe eel son cn eens 4 nnnnn 
BLOCK/BUFFER SIZE......................04. nonnn 
MIRAM KEY Loc LEN CHG DUP 
KEY1 nanan nnnan Y/N Y/N 
KEY2 nnnnn nannn Y/N Y/N 
KEY3 nnonnn nonnn Y/N Y/N 
KEY4 nanan nonnn Y/N Y/N 
KEYS nannn nonnan Y/N Y/N 
INDEX BUFFER SIZE......................... nnonnan 
RECORD CONTROL BYTE...................... ay 
ie 
RECORD SLOT SIZE.....................0...4. nnnnn 
DISK SECTOR SIZE...........0.0.00......04. Annann 
VOLUME MOUNT SETTING..................... et 
eee 
RECORD FORMAT.....................0020005 en 
ee 
FILE ORG...MIRAM(CONSEC)...RCOS UNEQUAL...nnnnnnnn 
INDEX 


MIXED 
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6.4. ERROR MESSAGES 


Error messages are handled the same as in the batch environment (2.4), except that they 
also are displayed on the workstation that initiated the dialog. They assume the default 
value of 7/7 PARAM DISPLAY= that is on the printer and system log file, as well as the 
initiating workstation. 


6.5. SAMPLE INTERACTIVE DIALOG 


' A typical tape-to-tape copy operation is provided in the following description. First, we must 
log on and ensure that the workstation is in system mode and that the input tape file is a 
single-volume file with standard labels in EBCDIC mode. We assume that in this example 
the file has a fixed block length of 800 bytes, with each record having 80 bytes; the volume 
serial number is TAPEO1; and the file identifier is TFILE1. 


The output tape file is a single-volume file having standard labels; it is in EBCDIC mode. 
Also, the block and record sizes are the same as for the input tape file. We have a variable- 
length block of 800 bytes and a record length of 80 bytes. The volume serial number is 
TAPEO2, with the file identifier of TFILE2. The tape is to be rewound before and after 
processing. 


Once you know your input and output file specifications, you can start the interactive file 
processing utility via the following command: 


RV I@DATA(DATAUTI){[, ,MEM=A888,ACT=PUBS] 


This command calls the interactive data utility and assigns 40,960 decimal bytes (AOOO) for 
the job. The job name is DATAUT1, allowing other users to use the utility. The account 
number is PUBS. (We did not specify the debug mode; thus, no snap dumps are provided in 
case of a hardware or software failure.) 


We now go through the tape-to-tape copy operation in the following steps: 


NOTE: 


In the workstation screens used for this description, the entries that appear in shaded 
typeface {7} are default values. The entries that appear in reverse print] are entered by the 
user. Terms in parentheses are protected fields and are not keyed in by the user. 





Step 1: Indicating the Operation 


After the RUN command is processed, the first menu selection screen is displayed: 


SCREEN 1 DUS@1 

DO YOU WISH TO 

1. COPY OR PRINT A FILE 

COMPARE TWO FILES 

CONVERT OS/4 FILES TO OS/3 DISK FILES 
CONVERT A S$/32-34 $COPY DISKETTE 
HELP 

NTER (1 THRU 5) | 


2 
3 
4 
5 
E 
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Since you want a tape-to-tape copy operation, press the transmit key (XMIT) (because 1 
is the default). 


If you want a compare operation, a conversion operation, or need HELP, enter a 2, 3, 4, 
or 5 (overwriting 1) and press the transmit key. 


Step 2: Choosing Primary File Type 


After you have indicated the type of operation, the following screen is displayed: 


INPUT SCREEN 1 DUS#2 
PLEASE ENTER THE TYPE OF YOUR PRIMARY FILE 
1. CARD 


2. TAPE 

3. DISKETTE 

4. DISK 

ENTER (1 THRU 4) (2 





Because your input file type is a tape, overwrite the default (1) with a 2 and press the 
transmit key. 


Step 3: Defining Input Record and Block Characteristics 


After you choose the primary file type, the following screen is displayed. 


TAPE SCREEN 2 DUS®#5 

PLEASE ENTER RECORD LENGTH, BLOCK LENGTH, RECORDING MODE, 
AND RECORD FORMAT 

1. RECLEN (REG) 


BLKLEN (GOR 

RECORDING MODE (E=EBCDIC oR A=ASCI!) [GM ee 
RECORD FORMAT (FIXBLK, FIXUNB, VARBLK, OR VARUNB) MARQQERD 
HELP (ENTER ITEM NUMBER OR 5 FOR ALL) (_) 





Since you have already chosen the input tape file specifications, enter the appropriate 
specifications in items 1 through 4. Since you are using the variable unblocked record 
format, choose the smallest record length (80) and the largest block length (800). 
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Step 4: Indicating Input Tape Rewind Option 





After you choose the record and block characteristics, the following screen is displayed: 


TAPE SCREEN 3 DUSO6 

PLEASE ENTER YOUR TAPE REWIND OPTION 

1. REWIND BEFORE AND AFTER PROCESSING 
REWIND BEFORE AND UNLOAD TAPE AFTER PROCESSING 
REWIND BEFORE BUT NOT AFTER PROCESSING 


2 
3 
4. DO NOT REWIND BEFORE BUT REWIND AFTER PROCESSING 

5. DO NOT REWIND BEFORE BUT UNLOAD TAPE AFTER PROCESSING 
6 DO NOT REWIND BEFORE OR AFTER PROCESSING 

7 HELP 

E 


NTER IED) 





Because you want to rewind the input tape before and after processing, overwrite the 
default (6) with a 1 and press the transmit key. 


NOTE: 


Only press the transmit key after making a selection, or a series of selections, on a menu 
selection screen. 





Step 5: Selecting the Input Tape Label Specification 


After indicating your tape rewind option, the following screen appears: 


TAPE SCREEN 4 DUS87 

PLEASE ENTER TAPE LABEL SPECIFICATION 
STANDARD LABELS 
STANDARD AND USER LABELS 


USER LABELS 


NO LABELS 
. HELP 
NTEREGS 





Since you are using standard labels, enter a 1 and press the transmit key. 
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@ Step 6: Choosing Tape and File Specifications 


After you choose the input tape label specification, the following screen is displayed: 


TAPE SCREEN 1 DUS#4 
PLEASE ENTER TAPE VOLUME SERIAL NUMBER, FILE NAME, 
AND FILE A NUMBER 


1 VSN KEES 


2. 
3. DRE 
4 HELP (ENTER ITEM NUMBER OR 4 FOR ALL) (_) 





Here, you enter the tape volume serial number TAPEO1 and its file name TFILE1. Since 
it is a single volume file, 1 is assumed. Press the transmit key for the next screen. 


| Step 7: Specifying Input File Catalog Password 


After you have defined your tape file characteristics, this screen appears: 


& CATALOGUE SCREEN 1 DUS54 


1. IF THE INPUT] FILE 1S CATALOGUED AND HAS 
A READ PASSWORD, PLEASE SPECIFY THE 
PASSWORD. 


NEED HELP (Y OR N) 





Since there is no password associated with your file, press the transmit key. 
Step 8: Specifying Multiple Input Volume Serial Numbers 


After you specify your catalog password, the following screen is displayed: 


MULTI-VOLUME SCREEN 1 DUS55 

PLEASE SPECIFY IN ORDER OF PROCESSING THE VSN NAME(S) OF THE 
ADDITIONAL VOLUMES YOU WISH DATA UTILITIES TO PROCESS. 

VSN2: VSN3: VSN4: 


VSNS5: VSNG6: VSN7: 
VSN8: VSNS: VSNIO: 
VSN11: VSN12: VSN13: 
VSN14: VSN15: VSNI6: 
& IF YOU NEED HELP PLEASE SPECIFY H FOR HELP. (_) 





Since you wish to process only one volume, press the transmit key. 
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Step 9: Selecting Output File Type 


After you specify your multiple volume serial numbers, this screen appears: 


OUTPUT SCREEN 1 DUS24 

PLEASE ENTER YOUR OUTPUT FILE TYPE 
PRINTER 
CARD 


TAPE 
DISKETTE 
DISK 





Since you want a tape output file, overwrite the default (1) with 3 and press the 
transmit key. 


Step 10: Specifying File Option 


After you specify your output file type, the following screen is displayed: 









OUTPUT SCREEN 2 DUS58 





ENTER FILE EXTENSION OR INITIALIZATION 
OPTION (APPLIES TO TAPE,DISKETTE, OR 
DISK OUTPUT ONLY): 

1. FILE TO BE INITHALIZED 

2. FILE TO BE EXTENDED 

ENTER (1 OR 2) (_) 









Since your file is to be initialized, enter a 1 and press the transmit key. 


Step 11: Defining Output Record and Block Characteristics 


After you indicate your file option, this screen appears: 








TAPE SCREEN 2 DUS85 


PLEASE ENTER RECORD LENGTH, BLOCK LENGTH, RECORDING MODE, 
AND RECORD FORMAT 
1. RECLEN 96089 







RECORDING MODE (E=EBCDIC OR A=ASCit) E 
RECORD FORMAT (FIXBLK, FIXUNB, VARBLK, OR VARUNB) VARUNB 
HELP (ENTER ITEM NUMBER OR 5 FOR ALL) _ 







wn & w h 
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Since you have chosen these characteristics earlier, you may now enter them: Assume 
the default of 80 for item 1. Overwrite the default in item 2 with 800 (since these are 
the smallest record length and largest block length). Overwrite the default in item 3 
with E. Indicate VARUNB in item 4. Press the transmit key. 


Step 12: Indicating Output Tape Rewind Option 


After you have input the record and block characteristics of your output tape, the 
following screen is displayed: 


TAPE SCREEN 3 DUS#E6 


PLEASE ENTER YOUR TAPE REWIND OPTION 
REWIND BEFORE AND AFTER PROCESSING 
REWIND BEFORE AND UNLOAD TAPE AFTER PROCESSING 


1 
2 
3. REWIND BEFORE BUT NOT AFTER PROCESSING 

4. DO NOT REWIND BEFORE BUT REWIND AFTER PROCESSING 

5. DO NOT REWIND BEFORE BUT UNLOAD TAPE AFTER PROCESSING 
6. DO NOT REWIND BEFORE OR AFTER PROCESSING 

7. HELP 

ENTER 6 





Because you want to rewind the output tape before and after processing, overwrite the 
default with a 1 and press the transmit key. 


Step 13: Selecting the Output Tape Label Specification 


After you indicate your tape rewind option, the following screen appears: 


TAPE SCREEN 6 DUS#9 


PLEASE ENTER YOUR OUTPUT TAPE LABEL SPECIFICATION 


1. STANDARD LABELS 
2. NO LABELS 

3. HELP 

ENTER 1 





Since you are using standard labels on your output tape, enter a 1 and press the 
transmit key. 
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Step 14: Choosing Output Tape and File Specifications 


After you choose the output tape label specification, the following screen is 
displayed: 


TAPE SCREEN 1 DUS®4 

PLEASE ENTER TAPE VOLUME SERIAL NUMBER, FILE NAME, 
AND FILE SEQUENCE NUMBER 

1. 
2. 
3. 
4. HELP (ENTER ITEM NUMBER OR 4 FOR ALL) 





Assuming that you request HELP on item 1, enter a 1 in item 4. The following HELP screen 
is displayed: 


* * * TAPE HELP DUH@411. * * * 


‘VSN’ SPECIFIES THE VOLUME NUMBER (VOL1 LABEL) ON THE TAPE VOLUME TO 
BE USED AS YOUR PRIMARY/SECONDARY FILE. THE VOLUME SERIAL NUMBER 
UNIQUELY IDENTIFIES THE TAPE REEL TO THE OPERATING SYSTEM. IT IS 
WRITTEN INTERNALLY (ON THE TAPE SURFACE) AND POSSIBLY EXTERNALLY 


(GENERALLY ON A GUMMED LABEL). THE VSN CANNOT BE MORE THAN SIX 
ALPHANUMERIC CHARACTERS AND THE FIRST CHARACTER MUST BE ALPHANUMERIC. 
IF THERE ARE LESS THAN SIX, TRAILING BLANKS WILL BE ADDED ON THE 
RIGHT. 


NEED MORE(IF ANY) HELP SCREENS? (Y/N=CONTINUE NORMAL PROCESSING)( ) 





This HELP screen gives you a description of the volume serial number and defines its 
purpose. If you understand the explanation, press the transmit key to continue normal 
processing. The screen prior to the HELP screen is again displayed. If you need more 
help, enter Y and another HELP screen is displayed. Here, we take the default by 
pressing the transmit key. 
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TAPE SCREEN 1° DUS#4 


PLEASE ENTER TAPE VOLUME SERIAL NUMBER, FILE NAME, 
AND FILE SEQUENCE NUMBER 


VSN [Rese 


HELP (ENTER ITEM NUMBER OR 4 FOR ALL) ( ) 





Now, we can enter the information for the output tape and file specifications. In item 1, 
TAPEO2 is entered for the volume serial number; in item 2, the file name TPFILE2 is 
entered. In item 3, because it is a single volume file, the default (1) is accepted. Press 
the transmit key for the next screen. 

Step 15: Specifying Output File Catalog Password 


After you have chosen your output tape and file specifications, this screen appears: 


CATALOGUE SCREEN 1 DUS54 


IF THE OUTPUT1 FILE 1S CATALOGUED AND HAS 
A WRITE PASSWORD, PLEASE SPECIFY THE 
PASSWORD. 


NEED HELP (Y OR N) 





Since there is no password associated with your file, press the transmit key. 
Step 16: Specifying Multiple Output Volume Serial Numbers 


After you specify your catalog password, the following screen is displayed: 


MULTI-VOLUME SCREEN 1 DUS55 
PLEASE SPECIFY IN ORDER OF PROCESSING THE VSN NAME(S) OF THE 
ADDITIONAL VOLUMES YOU WISH DATA UTILITIES TO PROCESS. 
VSN2: VSN3: VSN4: 


VSN5: VSNG6: VSN7: 

VSN8: VSNOQ: VSN10: 
VSNI1: VSN12: VSN13: 
VSN14: VSNI5: VSN16: 
IF YOU NEED HELP PLEASE SPECIFY H FOR HELP. (_) 





Since you wish to output to only one volume, press the transmit key. 





=—> 
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Step 17: Selecting Additional Options 


After you specify your multiple output volume serial numbers, this screen appears: 


OPTION SCREEN 1 DUS25 


PLEASE SELECT (Y OR N) ANY OPTIONS YOU REQUIRE 
FILE REPOSITIONING 


(Se ee le 


HALT ON RECORD COUNT 
CORRECTION BY RECORD NUMBER 


SELECTION/DELETION BY FIELD VALUE 
SEQUENCE CHECKING 
REARRANGE/CONVERT FIELDS 

SEQUENCE NUMBERING 

HELP (ENTER ITEM NUMBER OR 8 FOR ALL). (_ 





Since you don’t require any additional options, press the transmit key. 


Step 18: Selecting Data Card Option 


After you have indicated you do not desire additional options, this screen appears: 


DUAL CARD SCREEN 1 DUS45 


DO YOU WISH DATA TO PUNCH A CARD FILE CONTAINING THE 
FIRST 80 BYTES OF EACH SECONDARY FILE RECORD 


ENTER (Y OR N) 





Assume the default value (N) and press the transmit key. 
Step 19: Indicating Print Option 
After you have selected your data card option, the print option screen appears. 


The following screen is always the last screen before the end-of-job screen. It asks you 
whether or not your output file is to be printed. 
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DUAL PRINT SCREEN 1 DUS46 
DO YOU WISH DATA TO PRINT YOUR SECONDARY FILE 
AS IT IS CREATED 


ENTER (Y OR N) 





To take the default (N), press the transmit key. 
Step 20: End-of-Job Information 
After you indicate whether or not you would like your output file printed, this screen 


appears. Since the interactive dialog was successful, the interactive data utility displays 
the following end-of-job information screen: 


EOJ SCREEN 1 DUS49 
CONVERSATIONAL PHASE OF DATA UTILITIES COMPLETED 


... EXECUTION STARTED.... 





Once this screen is displayed, file processing begins and the workstation returns to 
system mode and is ready for the next user. 














e 


PART 4. LOADING LARGE, 
MULTIKEYED MIRAM FILES 
IN A BATCH ENVIRONMENT 
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7. MILOAD Utility — Special Purpose 
Loader for MIRAM Files 


7.1. MILOAD ~ WHY YOU NEED IT 


Until now, loading large, multikeyed MIRAM files by using conventional loading 
techniques resulted in long load times due to the number of I/O operations required to 
create the dynamic indexes for these files. You can significantly increase performance 
by using MILOAD, the more efficient fast loader utility program, whenever you need to 
load a large, multikeyed MIRAM file. There are, however, some considerations, 
restrictions, and trade-offs to consider before using this utility. 


7.1.1. Considerations before Using MILOAD 
s Your Operating Environment 


MILOAD only operates in a consolidated data management operating environment 
(CDM). It uses CDM to read and write the files it processes. Therefore, as a Series 
90 user, your system must support a CDM or MIXED mode environment to use the 
MILOAD utility. 


w User Responsibilities for Input Files 


As a user, you are responsible for preparing the input files processed by MILOAD. 
You must make certain that these files consist only of records that can be 
successfully added to the MIRAM file being created. For example, if you instruct 
MILOAD not to accept records that contain duplicate keys, then the input file to 
MILOAD must not contain records having duplicate keys. In addition, records 
containing illegal duplicate keys must be removed (sorted) from the input to 
MILOAD. To do this, use the standard OS/3 SORT program. You are also 
responsible for defining the criteria for record selection. Your input files can reside 
on disk or tape; disk files must be IRAM or MIRAM characteristic type files, and 
tape files must be created by OS/3 data management in EBCDIC mode. 
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= Output File Structure 


The output file created by MILOAD is always a MIRAM characteristic file. It must 
include one or more of the following criteria: 


— More than one key 

— Duplicate keys 

— Keys that may be changed during update operations 
- A variable file record format 

— A record control byte (RCB) 


When creating the output file MILOAD, we recommend that you avoid having data 
management automatically compute the physical sector size (PSS) for data 
partitions (VSEC=YES). The reason for this recommendation is that MILOAD uses 
large buffers to achieve performance; by specifying VSEC=YES, you create a 
situation where every program that later accesses the output file must contend with 
the inconvenience of large buffers. Therefore, performance is degraded. You may, 
however, specify a value for the PSS (VSEC=n), but make certain that you choose 
a value that is comfortable to work with throughout the life of the file. For 
additional information about VSEC, see the consolidated data management 
concepts and facilities manual, UP-8825 (current version). 


m= Need for Temporary Work Files 
MILOAD requires temporary disk work files to perform the sort process, which is 
an integral part of its operation. The amount of work file space required depends 
on the number of records involved and the key characteristics of the output file. 
The algorithm for calculating the amount of work file space needed for a given job 
is found in a later part of this section. 


@ Hardware Requirements 


MILOAD supports the following disk devices: 8418, 8430, and 8433. 


7.1.2. Restrictions 
MILOAD will only run in a CDM or MIXED mode environment. 


The output file is not usable until MILOAD successfully completes. Logical errors, 
hardware errors, and asynchronous termination leaves the output file that is created by 
MILOAD in a compromised state. It is your responsibility to ensure the successful 
termination of MILOAD. 


Sharing the output file with other jobs is not permitted. Use of the output file must be 
exclusive until MILOAD successfully loads all the records of a file. 
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7.1.3. Trade-Offs 


The primary objective of MILOAD is to increase performance when loading large, 
multikeyed MIRAM files. Achieving this goal affects flexibility, temporary disk file space, 
and main storage requirements. For example, MILOAD does not provide for record 
selection criteria and terminates abnormally for any hardware or logical error condition. 
Data-related errors such as illegal duplicate keys are not recoverable when using 
MILOAD. The input file cannot contain any records with duplicate keys for those output 
key structures that do not permit duplicates. 


MILOAD requires temporary disk file space for use by the SORT routine. This temporary 
disk file space could become a significant amount if the ratio of key data to record 
length is high. It could approach the size of the file being loaded. 


MILOAD requires 65k of main storage plus an additional amount for the sort work 
space and buffers. The total amount of main storage needed to execute MILOAD must 
be 85k bytes or greater. 


7.2. USING MILOAD FOR CREATING MIRAM CHARACTERISTIC FILES 


After reading Section 7.1, if you determine that you have the necessary resources and 
main storage to use MILOAD, you can easily put it to work loading your large, 
multikeyed MIRAM files. Your interface with MILOAD is through the OS/3 job control 
language (JCL). / 


The JCL assignment sets for your input, output, scratch, and print file devices are 
consistent with those used for running any job in an OS/3 environment. The control 
statements that define your file characteristics and execute MILOAD are compatible with 
the input and output statements used by the DATA routine. (See 3.1 and Table 3-1.) 
Examples are provided to assist you in preparing device assignment sets and run control 
statements. 


7.2.1. Device Assignment Sets for Defining Your Files 


Your MILOAD job stream must include device assignment sets for all your input, output, 
scratch, and print files. 


ws Input File 


The input file to MILOAD, as previously mentioned, can reside on disk or tape. You 
are required to identify the device type, its volume serial number, and the name of 
the file containing the input records for processing; you must also define the logical 
file name as INPUT1. The following examples illustrate the device assignment sets 
for disk and tape input files of your job stream: 
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Disk Input Tape Input 
// DVC 50 // DVC 90 
// VOL vsn // VOL vsn 
// LBL filename // LBL filename 
// LFD INPUT1 // LED INPUT1 


= Output File 


The output file created by MILOAD can only be a MIRAM characteristic file and 
must reside on disk. As with the input file, you must identify the device type to 
which the output is written, its volume serial number, and the name of the file to 
contain the output records. You must also specify the logical name of the file as 
OUTPUT 1. The device assignment set for your output file is: 


// DVC 50 

// VOL vsn 

// EXT MI,,,CYL,mi 
// LBL filename 

// LFD OUTPUT1, , INIT 


In this example, the INIT parameter indicates that the output file is a new file. You 
would omit this parameter from the LFD statement if the output file is an existing 
file. The EXT statement is required only if file space has not been previously 
allocated. 





If you want the output file created with recovery included, add a // DD RECV=YES 
to your assignment set. 


= ~§=6Scratch File 


MILOAD requires temporary work file space on disk for use by the SORT routine. 
The device assignment set for the scratch file not only identifies the device type, 
vsn, filename, and logical description; it also allocates the amount of temporary 
space required. This is a typical example of the device assignment set to be 
included in your job stream for a scratch file: 


// OVC 50 

// VOL vsn 

// EXT ST,,,CYL,mi 
// LBL $SCR1 

// LFD DMO1 


Note that the file label is specified as $SCR1, and the logical file description is 
DMO1. The extent statement (EXT) is required to allocate temporary space for the 
scratch file, and the mi parameter specifies the number of cylinders to be allocated. 
Finally, the specific amount of work space you need for MILOAD depends on: 





~ number of key structures involved; 
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— maximum (longest) key length; and 
— total number of records being loaded. 


Use the following algorithm to determine the amount of work space you need to 


run MILOAD: 
(A) (B) (C) 
= = 
where: 
S) 


Is the amount of space needed in terms of 256-byte sectors. 


A 
Is the size (maximum length) of the largest key plus 5. 
B 
Is the number of key structures. 
c 
Is the total number of records being loaded. 
D 


Is the physical sector size (256) of the scratch disk. 


To convert the space (S) value into cylinders, divide S by the number of blocks per 
track. Then divide the resultant quotient by the number of tracks per cylinder for your 
particular scratch disk. Add 20 percent as a size factor. 


r Printer File 


You must assign a printer to your job in order to run MILOAD. The device 
assignment set for the printer is as follows: 


// OVC 20 
// LFD PRNTR 


7.2.2. Control Statements for Running MILOAD 


The control statements for running MILOAD are compatible with those used by the 
DATA routine for copying MIRAM files. That is, MILOAD uses the input and output 
utility statement (Uio) and several of its keyword parameters (A, B, FV, L,, MK,, and 
OM) to accomplish the load operation you want performed. These statements define the 
type of load operation, the input and output device types, and the characteristics of the 
files being processed. 


The Uio statement and its parameters must be included between the start-of-data (/$) 
and end-of-data (/*) statements, which follow // EXEC MILOAD in your job stream. 
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A brief description of the Uio statement and its parameters follows. If you need a more @ 
detailed explanation of their function, refer to Section 3. 


gw Uio Statement 


The Uio statement identifies the device types you require for input and output. It is 
a mandatory statement that you specify in one of two forms: 


UDD 
Indicates that MILOAD is to perform a disk input to disk output operation. 


UTD 
Indicates that MILOAD is to perform a tape input to disk output operation. 


This statement must begin in column 2 or greater and need only be specified once 
in your job stream. At least one keyword parameter must be included on the same 
line of code as the Uio statement. For example: 


UDD A=(r,b) 
B=(r,b) 


Otherwise, MILOAD generates an error. 





= A=(r,b) Keyword Parameter 


The A parameter specifies the record size (r) and the buffer size (b) of your input 
file. This parameter is mandatory if your input file resides on tape. You need not 
specify this parameter for disk input files. In which case, the record size from the 
format labels is used; the buffer size is essentially ignored because MILOAD 
optimizes buffer size to achieve better performance. 


When your input tape file contains variable-length records, you must specify r as 
the minimum record length and b as the maximum block length. 


= B=(r,b) Keyword Parameter 
The B parameter is optional. When used, it defines the record size (r) and the 
buffer size (b) for your output file. If omitted, MILOAD uses the record size of your 
input file as the default value, essentially ignoring the buffer size since it optimizes 
buffer size for performance. When specifying r, do not include the record control 
block (RCB) as part of this value. 

= FV=(n) Keyword Parameter 


The FV parameter is aiso optional. When specified, it indicates two things: 


— The record format is variable length. 





~— The file slot size (n) 
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Make certain that the slot size (n) you specify is large enough to hold the largest 
expected input record. 


If omitted, MILOAD assumes a fixed record length format. 
m LL Keyword Parameter 


The L keyword parameter provides MILOAD with tape input label information. It is 
mandatory only when your input is on tape. You can specify this parameter in one 
of two forms: 


Lo 
Indicates standard tape labeled input. 


LC 
Indicates unlabeled tape input. 


m# MKn = (len,loc[,DUP][,CHG]) Keyword Parameter 


The MK parameter is mandatory. It defines the key specifications for your output 
file. Use it to identify the length and location of each key and to specify whether 
duplicate keys and key changes are permitted for particular key structures. 


€ You must include at least one key specification in your MILOAD job stream, but 
you are limited to a maximum of five specifications (MK1 through MKS5) for any one 
MILOAD run. If you specify more than one key specification, you must define them 
consecutively in ascending order beginning with MK1, MK2, and so on. 


You can specify a key length (len) from 1 to 80 bytes. The location of that field 
(loc) is also expressed in bytes. However, the value specified represents the 
number of bytes preceding the key field in the record, relative to zero. The value 
you specify for loc must be within the specified record length and must be less 
than 32,767 (maximum for MIRAM files). Keep in mind that if your input records 
are of variable length, the 4-byte header must also be considered to determine the 
actual key location. 


If you want to allow duplicate keys for the particular structure defined, include the 
DUP subparameter in your specification. Likewise, if you want key changes 
permitted during updates, include the optional CHG parameter. 


es OM=(I,n{,V][,R]) Keyword Parameter 


The OM parameter is mandatory. You use it to define the characteristics of your 
output file, i.e., via its subparameters, define the size of the index buffer needed to 
build your multikeyed output file, define the output as a multivolume file, and 
specify whether the output file is to contain a record control byte (RCB) for each 


@ record. 


You must always include the | subparameter as part of this specification. It 
identifies your output file as being indexed. 


UP-8069 Rev. 9 SPERRY UNIVAC OS/3 7-8 
DATA UTILITIES Update B 














The n subparameter is required to specify the size of the index buffer used to build 
your multikeyed output file. Buffer size is expressed as the number of 256-byte 
sectors you need to build your file. You can indicate from 1 to 10 sectors. 


The V subparameter indicates that the output file created is a multimount file (all 
volumes must be online). Because MILOAD only creates multimount files, V (the 
default) is always used. Therefore, you can ignore this subparameter. 


The R subparameter determines whether the output file contains an RCB for each 
record. When R is specified, MILOAD creates the output file without the RCB 
included. When R is omitted, the output file is created with the RCB included. 


The RCB should be included in the output file if the programs that later access this 
newly created file are concerned with record deletion. 


7.2.3. Sample Job Stream for Running MILOAD 


In the job stream that follows you will note that the input, output, and scratch files are 
located on separate devices. This is not a requirement, but is a performance 
consideration because it reduces unnecessary disk-head movement. 


// JOB MILOAD, , 18000 Job statement 
// DVC 20 // LFD PRNTR Printer file 
// DVC 61 // VOL DMTST1 





// LBL MILOAD. INPUT Input file 

// LED INPUT1 

// DVC 62 // VOL DMTST2 

// LBL MILOAD.OUTPUT Output file 

// LED OUTPUT1 

// DVC 50 // VOL RELO71 

// EXT ST,,,CYL,30 Scratch file 

“7/7 LBL $SCR1 

// LED DMO1 

// EXEC MILOAD MILOAD execution call 

/$ 

UDD A=(255, 1024) Input file record and buffer sizes 
B=(255, 1024) Output file record and buffer sizes 
OM=(1,1) Output file index buffer size 
MK 1=(4,8,DUP, CHG) Primary (first) key specification 
MK2=(13,6,DUP, CHG) 
MK3=(22,10,DUP, CHG) Additional key specification 

/* 

/& 


// FIN 
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7.2.4. Output Listing Produced by MILOAD 


In addition to creating your MIRAM characteristic output file, MILOAD generates an 
output listing after it successfully terminates. This listing provides you with: 


B a Statistical summary of the number of records loaded and the number of duplicate 
keys created for each key structure; 


m= the characteristics of the output file created including key specifications for all key 
structures, record size, and buffer size; and 


m device and file identification that includes the input device type, output disk type, 
input and output device volume serial numbers, and input and output file identifiers. 


Figure 7-1 is a typical example of an output listing produced when MILOAD successfully 
terminates. 





JCO6 USING DEV=301 VSN=UMTST1 

JCO1 JOB MILOAD3 EXECUTING JOB STEP MILOAD@@ #002 00:96:19 
START INDEX SORT 

END OF INDEX-SORT 

@1. KEY INSERT STARTED 

@2. KEY INSERT STARTED 

@3. KEY INSERT STARTED 


SORT MI@@ END OF SORT 

SORT A186 RECORDS IN 30@ RECORDS DELETED ® 

eeeeke NUMBER OF RECORDS LOADED BY MILOAD : 100 

AC1® LFD - PRNTR , FORM NAME - STAND1 , COPIES - 9001, PAGES - 00000001, STEP =002 

AC11 STEP #0@2 (MILOAD@O) USED 00064478 BYTES ELAPSED WALL CLOCK TIME=00:00:53#336 TOTAL SVC CALLS=000016690 
AC12 TERM CODE=000 SWITCH-PRIORITY=10 CPU TIME USED =00:00:40#671 TRANSIENT CALLS=00000079 


AC13 UPSI SETTING X'9@O! 
AC19 DEVICE EXCP's =00000486 =90000497 
AC21 JOB TOTALS USED 00064478 BYTES TOTAL ELAPSED WALL CLOCK TIME=00:01:13#128 AC22 TOTAL JOB SVC CALLS=00002331 


AC22 WALL CLOCK TIME OF ALL STEPS =00:01:06#319 JOB TRANSIENT CALLS=60000131 
AC23 TOTAL CPU TIME OF ALL STEPS =00:00:47#227 TOTAL JOB EXCP'S =090001232 


JCO2 JOB MILOAD TERMINATED NORMALLY hh:mm:ss 
A=(255, 1024) ,B=(255, 1024) 

OM=(1, 1) 

MK1=(4,8,DUP,CHG) 

MK2=(13,6,DUP,CHG) 

MK3=(22,10,DUP,CHG) 





Figure 7-1. Typical Output Listing for MILOAD (Part 1 of 2) 








6 ‘A8Y 6908-d/N 


S3ILMILN Viva 
€/SO DVAINN AYY3adS 





gq alepdn 
OL-Z 


KKKKK 


INPUT DEVICE 
OUTPUT DISC-TYPE 
INPUT FILE-NAME 
INPUT VOLUME - NAME 
OUTPUT FILE-NAME 
OUTPUT VOLUME -NAME 
INPUT RECSIZE 
OUTPUT RECSIZE 
RECORD CONTROL BYTE 
KEY NUMBER 1 LENGTH 
KEY NUMBER 1 LOC 
KEY NUMBER 2 LENGTH 
KEY NUMBER 2 LOC. 

KEY NUMBER 3 LENGTH 
KEY NUMBER 3 LOC. 
INDEX SIZE 

COUNT OF DUPLIC KEYS: 


NUMBER OF RECORDS LOADED 
DATE : yy/mm/dd TIME 


MIRAM LOADER PROTOCOL REREK 


DISK 
8418 
MILOAD. INPUT 
DMTST1 
MILOAD .OUTPUT 
DMTST2 
255 
255 
YES 
4 DUP=Y CHG=Y 
8 
13 DUP=Y CHG=Y 
6 
22 DUP=Y CHG=Y 
10 
256 
KEY1 KEY 2 KEY 3 
® () ® 
100 


hh:mm:ss 





Figure 7-1. Typical Output Listing for MILOAD (Part 2 of 2) 








SIILMILN Viva 
€/SO DVAINN AYYadS 


g alepdy 


6 “A8Y 6908-d/N 


LL-Z 
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7.2.5. Examples of Typical MILOAD Jobs 


The following examples give three variations of using MILOAD for loading large 
multikeyed MIRAM files. 


m= Example 1: Disk Input to Disk Output (Multidrive) 
In this example, MILOAD creates a 2-key output file with an RCB. Duplicate key and 


key changes are not allowed. The file contains fixed-format records. The record 
size is 256, and the input and output files are on separate volumes. 


// JOB MILOAD1, , 18000 Job statement 

// DVC 20 // LED PRNTR Print file 

// DVC 50 = // VOL VOL742 

// LBL INFILE // LFD INPUT1 Input file 

// DVC 514 // VOL VOL692 Output file 

// LBL OUTFILE // LED OUTPUT1,, INIT 

// DVC 506 // VOL VOL742 

// EXT ST,,,CYL,50 Scratch file — temporary 

// LBL $SCR1 // LFD DMO1 work space 

// EXEC MILOAD 

/$ 

UDD A=(255,256) ,B=(255, 256) 

OM=(1,1) 
MK1=(8,4) Utility input and output statement 
MK2=(6, 13) 

/* 

/& 


// FIN 
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& = Example 2: Disk Input to Disk Output (Single Drive) 


7-13 
Update B 


In this example, MILOAD creates a 2-key file with no RBC. Duplicate keys and key 
changes are allowed. The MIRAM file produced contains variable-size records, and 


the slot size for these records is 100 bytes. 


// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
/$ 


® : 
/& 


// 


JOB 
DVC 
DVC 
LBL 
DVC 
LBL 
DVC 
EXT 
LBL 
EXEC 


UDD 


FIN 


MILOAD2, , 18000 
20 // LFD PRNTR 
50 // NOL VOL742 
INFILE // LFD INPUT1 
50 // VOL VOL742 
OUTFILE // LFD OUTPUT1,,INIT 
50 // VOL VOL742 
ST,,,CYL,35 
$SCR1 // LFD DM@1 
MILOAD 

A=(100,512 


B=(100,512) 
OM=(1,1,V,R) 
FV=(100) 

MK 1=(8,4,DUP, CHG) 
MK2=(16,8,DUP, CHG) 


| 
| 
| 
| 


Job statement 
Print file 


Input file 


Output file 


Scratch file — temporary 
work space 


Utility input and output 
statement 
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m= Example 3: Tape Input to Disk Output 


In this example, MILOAD creates a 5-key MIRAM output file with a record size of 
50. 


No RCB, fixed format, duplicate keys, and key changes are allowed. The tape input 
is standard labelled. 


// JOB MILOADS, , 18000 Job statement 

// DVC 20 // LFD PRNTR Print file 

// DVC 90 // VOL TAPOO1 

// LBL TAPFILE // LFD INPUT1 Input tape file 

// DVC 50 // VOL VOL742 

// LBL OUTFILE // LED OUTPUT1I, ,. INIT Output disk file 

// DVC 5@ // VOL VOL742 

// EXT ST,,,CYL,70 Scratch files — temporary 

// LBL $SCR1 // LED DM@1 work space 

/$ 

UTD A=(50,50) 

B=(50,512) 
OM=(1,1,,R) Utility input and output 
L® statement 


MK 1=(6,14,DUP) 
MK2=(10,4,DUP) 
MK3=(17,6,DUP) 
MK4=(4,12,DUP) 
MK5=(5,27,DUP) 





/* 
/& 
// FIN 


7.3. MESSAGES — INTERFACE FOR USERS AND OPERATORS 


MILOAD provides both informational and error messages to assist you in using and 
understanding it. All messages are displayed on your console screen and recorded on 
your printer listings. 


7.3.1. Informational Messages 


Informational messages inform you of the current status of MILOAD during execution. 
They indicate when an important process begins. For example, MILOAD uses the SORT 
routine to sort the scratch file containing all the file keys. When this process begins, a 
SORT called informational message is displayed. An informational message is also 
displayed indicating that MILOAD has completed the sorting and is beginning 
construction of an indexed key structure. No action is required after these messages. 
They are strictly for your information, so you know the status of MILOAD and when it 
completes. 
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7.3.2. Error Messages 


If your job does not run successfully and is terminated by MILOAD, one or more error 
messages are generated and displayed explaining why the run was unsuccessful. The 
messages are self-explanatory and can be used to remedy the error condition. The error 
messages are listed directly below the run statements on the output listing generated by 
MILOAD and are formatted as follows: 


DUFnn BAe message text 
Ss 


where: 
nn 
Is the message number. 
W 
Indicates that the message is a user warning. 
s 


Indicates that the error is serious and that the UPSI byte is set to X‘40’. 


For a complete listing of all MILOAD error messages, refer to the system messages 
programmer/operator reference, UP-8076 (current version). 


7.3.3. Unrecoverable Error Conditions 


In addition to the error messages, there are five possible CANCEL exit paths that signify 
unrecoverable errors. They are identified as follows: 


Open error Results in a DUF45 error message and CANCEL termination 
Error writing index Results in a DUF28 error message and CANCEL termination 


Error reading INPUT 1 Results in a DUF29 error message and CANCEL termination 


Error writing Results in a DUF30 error message and CANCEL termination 
OUTPUT 1 
Error in sort Results in a DUF45 error message and CANCEL termination 


7.4. ADDITIONAL FEATURES OF THE MILOAD UTILITY 


In addition to loading large, multikeyed MIRAM files, MILOAD can bulk extend (add large 
numbers of records to) an existing MIRAM file. The same restrictions and constraints 
previously noted for file creation apply to this added capability of MILOAD. Performance 
varies for bulk extending and is dependent upon the relationship between the key values 
of the records being added to those of the records already existing in the file. 
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Before attempting to bulk extend an existing file, we recommend that you do two 
things. First, make certain that the records being added to the existing file are not in 
conflict with that file. That is, make sure that you have not defined file specifications to 
MILOAD that differ from those that exist for the existing MIRAM file. An example of 
these differences could be format differences, RCSZ differences, key differences, etc. 
Second, make a backup copy of the existing file. This will allow you to restore the 
original contents of the file, should MILOAD terminate your job due to an error 
condition. Use the DUMP/RESTORE facility to back up your existing file. Output file 
shareability during bulk extending is not permitted. MILOAD requires the file exclusively 
until it has successfully completed. 
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Appendix A. Statement Conventions 


This appendix contains descriptions of the conventions that you must follow to properly code 
the statements to express the DATA routine operations you desire. Coding conventions for 
subparameters, optional and required keyword parameters, and punctuation marks are given. 
The use of capital and lowercase letters in the DATA routine statements is explained. 


The conventions used to present the DATA routine statements are as follows: 
= ~=—s Information that must be coded exactly as shown is presented in uppercase letters. This 
information denotes control statement mnemonics or keyword parameters of a DATA 
routine utility statement. 
Examples: 
UCD A=(80,88),DC,11,K1,0S 


SEL D=1 
COR N=(1),A=(5), B=(6) 


a Information that must be supplied by the user is presented in lowercase letters. 


Examples: 
Q=(c,s,n,i) 
X=(r,s) 


u ~=©Fieid select (FS) statement parameters are positional and must be coded in the order 
shown in the description of the FS statement in 3.3.1. 


Examples: 
FS a,b,c/CV/a,b,c 


FS CV/a,b,c/a,b,c 
FS a,b,c/a,b,c/CV 
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=" Information contained within braces represents alternate choices, only one of which 
may be chosen. 





Examples: 


“ee 
ih 


7 Information contained within brackets represents optional entries that may be 
included or omitted. Braces within brackets signify that one of the specified entries 
must be chosen if that parameter is specified. 





Examples: 


L {ee 
DP 
JS FF 
FV 
# Commas, virgules (/), and parentheses must be coded exactly as shown. 


Examples: 





UCC A=(r,b),B=(r,b) 
FS a,b,c/CV/a,b,c 


= An ellipsis (a series of three periods) indicates the omission of a variable number of 
entries. 


Example: 


A<(sssss,aa...a) 


= A keyword parameter may contain a sublist of parameters called subparameters, 
which are separated by commas and are positional within parentheses. 


Examples: 


Q=(c,s,n,i) 
FS a,b,c/a,b,c/a,b,c 


L Commas are required when positional subparameters are omitted, except after the 
last subparameter specified. 


Examples: 





Q=(c,.s.,i) 
Q=(c,s) 
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= Subparameters contained within brackets are optional. If included, they must be 
coded in the order shown. If omitted, a comma is required in their place. 


Example: 
OR=(I[,p]{,$].[.V¥]) 
can be coded as 


OR=(!,,V) Or OR=(1,2) 





n 





default specification occurs in the format description, it is printed on a 
: _ background. If, by parameter omission, the operating system performs 
processing other than parameter insertion, it is explained under an “if omitted” 
heading in the parameter description. 





Examples: 





™ ~Entries made by the user are indicated in this document in reverse print (ZEEE 


= Parameters may be coded through column 71 and must be followed by at least one 
blank column. 


m The statement identifier (Uio, FS, SEL, DEL, COR, and PAR) may be coded in any 
columns between 1 and 71. It must be followed by at least one blank space and, 
unless starting in column 1, preceded by at least one blank space. The Hn statement 
must start in column 2. 


= With the exception of the Hn statement, statements cannot be continued. Additional 
parameters are coded by repeating the statement identifier. Parameters or fields 
must not be split between two cards. 


Examples: 


UDD B=89,132,DP,G=18,H=5608 
UDD MY,01,Q,R=1609,S2,TD 


PAR P2P3,PiP2,P3P1,P1=(72,720,FIXBLK,58,29) 
PAR P2=(188,1009,FIXUNB,38,10868),P3=(9,86,KEYED, 28,58) 


Hn statements are continued by coding a nonblank character in column 72 and 
resuming the character string in column 2 of a second card. (See 3.3.3 for coding 
rules for the Hn statement.) 
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